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REMOTE 
CONTROL 


Create your own Raspberry Pi-powered rover with our latest guide 


Get candid shots of your 
fishy friends with our help 


Magical magnetic 
chess project straight 
out of Harry Potter 


New Europe-wide Astro Pi | 
competition now open = 
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THE FINAL PART OF OUR ARCADE CABINET GUIDE 
INSTALL WITH NOOBS & CONFIGURE YOUR PI 
HOW RASPBERRY PI IS HELPING BUILD CARS 
MONKMAKES ROBOTIC PUPPET KIT RATED 


ONLY 


TAKING OFF IS EASY 
WITH THE RIGHT 
FOUNDATION. 


With 


HASSLE-FREE 
OS INSTALLER 


With a custom version of the NOOBS 
(New Out of Box Software), included on 
your microSD, you can download your 
Raspbian operating system of choice 
in a matter of moments. 
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to get you started on custom maker 
projects, the WD PiDrive Foundation Edition has everything you 
need to to start learning how to make creations of your own. 


EASY 
OFFLINE SETUP 


The included SD card comes with Raspbian 
PIXEL and Raspbian Lite pre-installed, giving 
you two starter operating systems from the 


Raspberry Pi Foundation to experiment with. 


SWITCH BETWEEN 
PROJECTS ON THE FLY 


With the ability to partition the 
WD PiDrive Foundation Edition into 
Project Spaces, you can create a custom 
storage solution to fit multiple projects 
on the same Pi and drive arrangement. 
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WELCOME TO 


THE OFFICIAL 


MAGAZINE 


e’re still riding high on the success 
of last month’s 50th issue, in which 
we counted down the best Raspberry 
Pi projects ever made. The response from our 
readers to the public-voted portion of our 
countdown ~— the all-important top 20 — was 
astounding, so please accept our heartfelt 
thanks for making it such a memorable 
community event! 

We’re back to business as usual this issue. 
Just the standard, everyday, run-of-the-mill 
articles you’ve come to expect from the 
magazine on a month-by-month basis. 
Standard stuff like shooting your code 
into space, building awesome robots, 
mastering essential computing expertise, 
and bootstrapping the impossible with 
nothing more than affordable technology, 

a free weekend, and the skills to succeed. 
Just the usual. 


Enjoy the issue! 


Russell Barnes 
Managing Editor 
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TUTORIALS 


> RASPBERRY PI 101 — NOOBS 


Install one of many OSes with NOOBS 


> RASPBERRY PI 101 — CONFIG 


Change the way your Raspberry Pi works 


> HOW TO USE SCRATCH 2.0 


Upgrade Raspbian with PIXEL to use Scratch 2.0 


> UNDERWATER CAMERA 


Build a waterproof, Pi-powered camera 


> INTRO TO C PART 5 


How to use pointers in your code 


> BUILD A WIFI DETECTOR 


Find out who's been at your house by using WIFI 


> CREATE A STATUES GAME 


Play statues with a Raspberry Pi in the Pi Bakery 


> ARCADE MACHINE PART 5 
Finish building the RaspCade 


> MAKE PONG WITH PI CAP 


How to make Capong, a physical version of Pong 
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Upgrade your Pi media centre with a PVR 
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NEW ASTRO PI COMPETITION 
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Astro Pi is back with a Europe-wide 
challenge for kids to enter! 
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PHOT 
WINNERS 


Element14's community challenge 
is over, with some amazing results 
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Scare your friends with these quick Halloween Meet Matt Reed, American } 
projects you can do in time for the big day maker extraordinaire 
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ESA astronaut Thomas Pesquet is challenging 


school students across Europe (credit: ESA/NASA) 


Students and teachers should first assemble 
a mission team, which must include at least 
one support teacher as well as students under 


the age of 16. Use the Mission Plan Template 


(magpi.cc/2enYSWP) to design a sample mission 
that showcases your approach to running a space 


mission, and demonstrates that you can break 
down your big idea into concrete steps. 


The deadline for the first round of applications 


is 13 November 2016. 


Teams from France should register in French 
through the Centre National d'Etudes Spatiales: 


magpi.cc/2e01zYh. 


Teams from Poland should register in Polish 
through ESERO Poland: magpi.cc/2dUyJya. 


Teams from the other ESA Member States 
should register and upload their mission plan 
(in English) with ESA: magpi.cc/2e03Fre. 


If you're looking for inspiration, take a look at 
the winners from Tim Peake’s Astro Pi mission 
(magpi.cc/2e0258N). 
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BLASIS 
BACK INTO SPACE 


Brand-new European mission for Astro Pi units sees students 
across Europe developing code for Ed and Izzy 


he European Space Agency 

(ESA) and the Raspberry 

Pi Foundation have 
teamed up to run a brand-new 
Astro Pi challenge. 

Space cadets will get another 
chance to create code for Ed and 
Izzy, the two Astro Pi units on 
board the International Space 
Station (ISS). For this mission, 
students from France, Spain, 
Germany, and other European 
countries will join young coders 
from Britain. 

This time around, ESA French 
astronaut Thomas Pesquet will run 
code on Ed and Izzy. 

Thomas is ready to blast into 
space in November 2016. He will 
serve on board the ISS as a flight 
engineer for Expeditions 50 and 51. 

“Tm currently at the European 
Astronaut centre,” he told us. 
“Tm training for my Proxima 
mission. Ill be going to the 
International Space Station 
this autumn, for six months.” 


All aboard the ISS 


“We have a Raspberry Pi computer 
on the International Space Station, 
which is being programmed by 
school students,” said Dave Honess, 
programme manager for Astro Pi. 

“Think about how profound that 
is for a school student,” continued 
Dave, speaking at the Space for 
Inspiration conference. “You can 
have something you’ve made up in 
space; that’s what Astro Pi is.” 

Getting the Astro Pi devices on 
board the ISS in the first place was 
no easy feat for the Raspberry Pi 
Foundation, so it’s fantastic to 
see them doing a second mission. 
“Tf you want to fly anything to the 
International Space Station, even 
if it’s a small payload, you have 
to have something called a Flight 
Safety Certificate (FSC),” said Dave. 
“Our FSC was quite hard to get, 
because as an educational payload 
we were quite unusual.” 

The Astro Pi units went up for 
Major Tim Peake, a British ESA 
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Our two Astro Pi devices, Ed and Izzy, are still hard 


at work on board the ISS (credit: ESA/NASA) 
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Astronaut. Tim manually uploaded 
code, developed by UK school 
students, to the boards. 

Before Tim left the ISS, he 
plugged in an Ethernet cable to the 
Astro Pi devices. “So we now have 
Space-to-ground communications 
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Above Ed and Izzy, the two Astro Pi devices 
flying on the ISS (credit: ESA/NASA) 
two very special items on board for 
me: two Astro Pi computers.” 

Each Astro Pi contains a standard 
Raspberry Pi 2 and a Sense HAT. 
“So get ready,” continued Thomas, 


We now have space-to- 
ground communications 
with the Raspberry P1 


with the Raspberry Pi,” said 
Dave. “We can remotely access it 
to deploy new student code and 
download experiment results, 
which we didn’t have in Tim’s 
mission. He had to take the SD 
card out and plug it into a laptop, 
which was time-consuming.” 


Ed and Izzy flying high 
“My friend and fellow ESA 
astronaut Tim Peake just finished 
up his ISS mission,” said new 
astronaut Thomas. “He has left 
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“since a lot of exciting science 
can be done with the Astro Pis. 
I’m very glad to invite you to join 
the Astro Pi School Challenge. I 
will challenge you to run a coding 
competition, based on the mission 
that I will assign you. 

“You may even have the 
chance to send your code to the 
Astro Pi on the ISS, where it will 
run in space,” said Thomas. 
“Have fun learning. I can’t wait to 
see all the code that you come up 
with. So, see you soon!” 


ASTRO PI BLASTS BACK INTO SPACE 


News 


ASTRO PI 
IN NUMBERS 


£2 
400km 


ABOVE THE EARTH 


£2,900 


COST OF EACH 


ASTRO PI FLIGHT CASE 


£4,000 


COS VOreE Palen Nin GATS leeanOlR 
SPACE-TO-GROUND COMMUNICATION 


8,000 


RESIPOINIDISID) WO IeS/NS 
‘DO YOU WANT TO BE 
AN ASTRONAUT? AD 


£72 BILLION 


ESTIMATED VALUE OF ISS 
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ROBOTS © 


Rui Peixoto, 

Pedro Lopes, and 
Gongalo Marques 
stand on top the 
AGV in the Peugeot 
Citroén factory 


Robot controlled by Raspberry Pi carries cars around the factory 


he Raspberry Pi is taken 

incredibly seriously 

in engineering, with 
thousands of our favourite 


computers embedded in industrial 


projects around the world. 

Peugeot Citroen has taken 
the Raspberry Pi to heart. The 
company is using Raspberry Pi 
boards to revolutionise the way 
it builds cars. 

The jewel in its crown is this 
automatic guided vehicle (AGV) 
used in its Portugal factory. We 
spoke to Pedro Lopes, manager 
of the engineering department. 
“In our weld shop, the cars 
are transported in a wheeled 
iron structure that we call ‘the 
chariot’,” he tells us. 

Vitor Duarte, Peugeot Citroén's 
weld shop manager, challenged 
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The Raspberry Pi and other 
components live inside the white 
box on the front of the robot 


Pedro to build a low-cost, but 
reliable, solution for carrying 
the chariots “without using 
human hands”. The manager 

of IT infrastructure, Carlos 
Mesquita, sponsored the project. 
“He’s a believer in these types 
of solutions,” says Pedro. The 
Raspberry Pi AGV was born. 

“Our metalworkers made the 
completely iron structure,” 
recalls Pedro. “At the same time, 
the programmers, who are all 
Raspberry Pi fans, started to 
choose the components and began 
writing the code.” 

The result is a giant, 
autonomous robot, which is used 
to lift and move cars around the 
Peugeot Citroén factory. 
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Chariot driving 

The AGV contains a Raspberry Pi, 
a touch display, a12-channel USB 
servo controller, and a RoboClaw 
ST 2x45A motor controller (which 
drives the two DC motors). 

A Robotegq MGS1600 magnetic 
band sensor is used to guide the 
AGV along the track that runs 
around the factory. “It travels 36 
metres per cycle,” says Pedro. 
“We currently have a production 
of 220 cars per day; it travels 7,920 
metres per day.” 

The robot sports a RoboPeak 
RPLIDAR 360° scanner for safety. 
“The RPLIDAR is used for people 
detection,” explains Pedro. So 
the AGV will stop automatically 
if a person is in its way. 
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he Alexa Voice Service 

(AVS) API for Raspberry 

Pi now includes 
hands-free functionality. 


“Any digital maker using the free 


API from the Amazon Developer 
team had to add a button to their 
build, putting a slight dampener 
on the futuristic vibe of the 
disembodied Alexa,” writes Alex 
Bate, Raspberry Pi’s social media 
editor. “We know about this 
because a bunch of you [makers] 
complained about it.” 

This update removes the press- 
a-button limitation. Makers can 
now use Alexa by issuing a wake 
word, calling out to “Alexa”, 
“Echo”, or “Amazon”. 


HUMAN MACHINE 


If you’re looking for ideas 
for builds, check out the 
Internet of Voice Challenge that 
Raspberry Pi and Hackster hosted 
(magpi.cc/2baErdf). Winning 
builds included a voice-activated 
Baseball Pitching Machine, a voice- 
controlled K’nex Car, and a Smart 
Cap for the visually impaired. 


The update to Amazon's Alexa 
API now enables Raspberry Pi makers to 
create hands-free devices similar to the 
Amazon Echo Dot 


INTERFACE 9g 


roy Miller, applications 
engineer at Galil Motion 
Control, has developed 
a human machine interface 
(HMI) using Galil software 
and a Raspberry Pi 
The result is a cheap, powerful 
HMI perfect for industrial 
environments, without having 
to use a full-sized PC. 
“There are many sources 
for HMIs, and many can cost 
thousands of dollars,” says 
Troy. The Raspberry Pi is a much 
cheaper option, but it also comes 
with a 7-inch touch display, and 
now it can run Galil’s motion- 
control software. 
“This powerful trio forms the 
foundation for an inexpensive but 
fully capable HMI, customised for 
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any motion-control application,” 
says [roy. 

“There are free software tools 
that can allow a person to create 
just about any interface to run on 
the Raspberry Pi,” he adds. “The 
software acts as the glue to take in 


the input from the user in the touch 


interface, and the Galil gclib API 


translates those simple instructions 


into the commands to send to the 
machine motion controller.” 

Troy has made an excellent video 
demonstration of a Raspberry 
Pi running Galil software to 
control a stepper motor linear 
stage (magpi.cc/2dSXGYu). 


The stories that made waves on 
our social media sites this month 


— 


We were taken aback by the sheer weight of 
community love for the Top 50 feature (from The MagPi 
issue 50). Our Top 50 photo album got a huge amount of 
attention on Facebook. 


This project generated "Ve 


magpi.cc/2dT2Qnk 


lots of love on Twitter. 
James Mitchell's 
ingenious device 

can take 360-degree 
panoramas and 

even time-lapses. It 
features eight Pi Zeros 
equipped with Camera 
Modules, placed 
around a laser-cut 
wooden housing. 


magpi.cc/2dT46qz 


Rob's review of the crowdfunded laptop that gamifies 
the hardware building process piqued the interest of 
our lively Google Plus community. 


November 2016 (/0.97 


Tom Hartley, president of Imperial 
College Robotics Society; Amy Mather, 
winner of European Commission's Digital Girl 
award; and Matthew Timmons- Brown, The 
Raspberry Pi Guy 


—— 


ucky members of the 
~ Raspberry Pi community 
attended a special event at 
St James Palace on 5 October. 

The Duke of York, HRH Prince 
Andrew, invited members of the 
Raspberry Pi community to the 
event to celebrate all the good work 
that they do. 

Invitees were free to mingle with 
members of the community, and 
learn about Code Club and Raspberry 
Jam events, while taking in the 
splendour of the palace. 

There were inspirational speeches 
from the Raspberry Pi Foundation 
CEO Philip Colligan, Code Club UK 
co-founder Clare Sutcliffe, and The 
Duke of York himself. 

“The event at St James’s 
Palace was an opportunity for 
us to celebrate the awesome 
achievements of our community of 
makers, educators, volunteers, and 
young people,” says Philip Colligan. 
“More than anything, Raspberry 
Pi is acommunity and we really 
just wanted to say thank you for 
everything they do.” 
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Raspberry Pi community invited to meet the Duke of York 


at St James’s Palace 


Hannah 
Belshaw, from 


Cumnor House Girls’ 


School in Croydon, 
was an Astro Pi 
winner with her 
idea to represent 
data from the Astro 
Pi in the world 

of Minecraft 


Maria 
Quevedo, Clare 
Sutcliffe, and 
Rik Cross from 
Code Club UK 


fs) 


More than anything, Raspberry Pisa 
community and we really just wanted 
to say thank you for everything they do 


Grand old duke 

“The Duke of York is patron of 
the Raspberry Pi Foundation and 
was also the patron of Code Club 
before we merged,” explains 
Philip. “So he hosted the event 
and gave a heartfelt speech about 
the importance of computing and 
digital making education.” 

Places for the event were 
extremely limited. “The only 
downside was that we could only 
fit 150 people in the room,” Philip 
tells us, “and, of course, our 
community is much, much bigger 
than that. That’s why we’re always 
thinking of more ways to celebrate 


and support our community to 
erow and achieve more.” 

The event came shortly after the 
news that the Raspberry Pi had sold 
over ten million units in total. It 
Was a great opportunity to reward 
some of the community that had 
made this British computer such a 
success Story. 


ar —_— 


raspberrypi.org/magpi 


This NEC display is seriously smarter 
than its rivals thanks to the Raspberry Pi 
Compute Module embedded inside 
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NEC DISPLAY 
WITH PI INSIDE 


Custom Raspberrry Pi Compute Module makes 
new NEC display super-smart 


EC has announced a new 
display with a Raspberry Pi 3 
Compute Module inside. 

“We think that the large-format 
NEC displays will be suitable for a 
very broad range of applications,” 
says Eben Upton, CEO of Raspberry 
Pi Trading. “Obviously digital 
Signage applications, but there are 
also opportunities for interactive 
presentations and a broad range of 
oT projects.” 

The Raspberry Pi Compute Module 
comprises the guts of a Raspberry 
Pi 3 board. Other projects can have a 
Raspberry Pi embedded inside. 

NEC has customised the Compute 
Module with a larger than usual 
16GB of flash storage. 

“People are using Raspberry 
Pis to add intelligence to their 
products,” explains Eben. “We’ve 
been fortunate enough to have sold 
10 million Raspberry Pis so far, and 
the commercial success has led 
to the third generation of a more 
mature and powerful technology 
which can be used with NEC’s 
intelligent display.” 
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Developer powered 

“Our work on the Raspberry Pi 
mini-computers is driven by the 
huge community of developers,” 
continues Eben. “Overall, this 
collaboration shows NEC’s 
confidence with our ability to 
provide a platform that can be used 
in a variety of environments.” 

“Integrating the Raspberry 
Pis with our displays will provide 
businesses with advanced technology 
suitable for digital signage, 
streaming, and presenting to 
enhance the overall visual experience 
at an affordable price point,” 
says Stefanie Corinth, senior VP 
marketing & business development 
at NEC Display Solutions. 

“Tt’s an incredible vote of 
confidence in the Raspberry Pi 
Compute Module platform from a 
blue-chip hardware vendor, and 
will hopefully be the first of many,’ 
concludes Eben. 


) 


The displays are designed for public 
signage and presentations; the range starts 
at a 40-inch size 


OPEN INDIRECT 
OPHTHALMOSCOPE 


This ultra-low-cost eye screening 
device uses machine learning to 
Save eyesight in India 


9 The 010 scans the 
: retina and uses 

machine learning 
to diagnose 
problems. The 
touch screen on 
the front displays 
the diagnosis 


he Raspberry Pi is being used to save the 
eyesight of people in India thanks to the 
Open Indirect Ophthalmoscope (OIO) project. 

“The OIO is a portable retinal camera that uses 
machine learning to make diagnosis not only 
affordable but also accurate and reliable,” explains 
Sandeep Vempati, a mechanical engineer at the 
Srujana Center for Innovation. The device uses a 
Raspberry Pi to drive down the cost of diagnosis. 

“Currently, visual impairment affects 285 million 
people worldwide,” reveals Sandeep. “What's 
more surprising is the fact that 80 percent of all 
visual impairment can be prevented, or cured if 
diagnosed correctly.” 

“India is the diabetic capital of the world,” 
says Dr Jay Chhablani, a retinal disease specialist. 
“Diabetics affects the retina and leads to something 
called ‘diabetic retinopathy’. If we see the patient 
at an early stage of diabetes, we can treat these 
patients by controlling diabetes and applying 
laser treatment.” 

“3D printing creates the OIO for a fraction of the 
cost of conventional devices, and yet maintains the 
same quality,” says Sandeep. The OIO costs S800 to 
build. Conventional retinal cameras cost ten times 
as much. 

OIO’s Hackaday page (magpi.cc/2dVtqfN) lists the 
required components. “Engineering feels great when 
you see a product being useful in the real world,” 
enthuses Sandeep. 


The case is 3D printed, and the components are low- 
cost and widely available. The project is open-source so 
anybody can build one 
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News 


MEE! THE 


WINNERS of 


PITOT SMARTER SPACES 


Element14 tasked makers with creating an IoT command centre using a Pi 3 


he elementi4 Raspberry 
Pi community is a pretty 


you want to catch some great Pi- 
related maker projects. In the past 
we’ ve featured projects straight 
from here, like a super-scary 
haunted door and even a Pi Zero 
soldered into a CRT TV for retro 
gaming. Recently, the community 
held a design challenge called 
PiloT, with the aim to create 
‘Smarter Spaces with Raspberry 

Pi 3’. Using a Pi 3, contestants 
were tasked with creating a better 
command centre for all their IoT 
devices in a specific area. The 
winners were announced just after 
we went to print last issue, but 
they’re pretty cool so we thought 
we’d introduce you to them now! 
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amazing place, especially if 


And the winners are... 


Plant health smart camera 


Maker: Gerrit Polder 
magpi.cc/2ej7RnP 


Gerrit’s project isn’t even about 
an IoT home, but an IoT farm. 
This project uses two Pi Camera 
Modules, anormal one anda 

Pi NoIR camera, along with 
OpencCV to track plant health. 

It’s a contained system witha 
purpose-built display anda slave 
Raspberry Pi Model B+ to operate 
the other camera. This method 
uses the same technique as the 
Enviro Pi experiment that was 
carried out on the ISS for Astro Pi: 
Normalized Difference Vegetation 
Index (NDVI). The images are 


combined in this method, which 
can then be reviewed on the 
system itself. 


Thuis 


Maker: Robin Eggenkamp 
magpi.cc/2ejjbjS 


Thuis is a full home automation 
system with the Raspberry Pi at 
the core. The original brief was 
to have a smartphone greet you 
as you get home, and to have the 
house react as you move through 
it. This has been accomplished, 
with lights turning on as you 
enter rooms and acustom UI 
that lets you control lighting, 


Below A simple 

interface for Thuis 
that controls many 
parts of the house 


®) device 


@ control 


GB Rodiator music, and other media aspects 
Sire ) canEGr throughout the home. It’s a very 
: 08 powerful and complex system, 
7 * {Beacon . 
pr Robin has also put together 
1) Uahe some fantastic documentation 


GES i 
(©)) 


for it if you wish to follow in 
his footsteps. 
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Element14's community has regular challenges 
that people can enter - PiloT was the second 

of the year - and they always have pretty good 
prizes, too. PiloT’s first prize was a 3D printer, and 
the runners-up managed to go home with a huge 
selection of kit, including some power tools. Keep 
an eye out on the element14 contest pages for the 
next round: magpi.cc/2ejj9gbB. 
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= | With an included SD card preloaded with the Project 
Sl <i Spaces installer, the WD PiDrive Foundation Edition 
" lets you create independent work spaces for multiple 
projects on a single drive so you can switch between 
your creations on the fly. 
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feature 


BUILD A 
ABMO Ir 
CON] ROL 
ROBOT 


Make a Pi Wars-winning robot with our expert Brian Corteil 


his is no ordinary robot build. Over the next 
few pages, we are going to show you how to 
design, build, and program a robot capable 
of winning a robotics competition; the best part is, 
anyone can make one! 

In this feature, we will take you thought the 
steps required to build this amazing robot. 
We’ll look at different types of components 
you could select, how to program it, how to 
build it, and then how to control your robot. 
We’ll even have some tips for if you want 
to enter your robot into a competition. 
Read on and we can get started... 
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This is the robot we're building. The four-wheel direct drive 
chassis is acommon design for a robot, and can be bought 
as a kit from many stores. Four-wheel direct drive robots 
have many advantages over two-wheeled robots: they have 
more torque, more grip, they're faster, and are able to turn 
on the spot. This makes the robot nimble and very suitable 
for challenges like the maze and the obstacle course. 
Disadvantages include a higher cost due to the 
greater number 
of motors and 
more expensive 
motor controller 
to use them. 


Tank tracks are cool. They have loads of grip 
when matched to the surface you are running 
on, are great over rough ground, and you can turn 
on the spot. However, they can difficult to build. The 
alignment of the tracks needs to be spot on when 
installing them, or you will risk the track slipping 
off. Tracks can also be slower than 


wheels because there's 
more friction on them. 
Omnidirectional robots are 
Six-wheel direct drive robots Olea bee eh ola ae 
have most of the advantages of in sumo-style contests like Pi Noon 
both tracked and wheel robots, 


offering good grip, high torque, and 


at Pi Wars, as they can move in any 
direction. The downside is they are not so 


manoeuvrability. The use of multiple great on rough ground due to the design of 


motors balances their output. their wheels. The wheels are complex and can 


Disadvantages for this type are the be quite expensive to buy, and you'll need to do 


a lot more coding on them. The maths behind 
cost of six motors, wheels, and a motor 


controller powerful enough to supply getting it to work can be very cool, but it’s also 


scary enough to make you want to run and 


the juice required. 
hide behind the sofa. 


PICK YOUR 


How will the robot 
get around everywhere? 


otors come in many sizes, types, with/without 
gearboxes, etc. Common motor types used in 
maker projects are brushless, brushed, and 
stepper (see more details on the right). When selecting 
a motor, you need to consider its voltage rating, free- 
run current, stall current, and type. The free-run (or 
operating) current is how much current the motor will 
draw when running; with this information, you’ll be 
able to estimate how much power the robot needs. 

This is important for a reliable design, as 
you’ll need to match the motor and controller 
characteristics; if you use a motor that has a voltage 
rating higher than the motor controller, you won’t get 
the full potential out of the motor. If the stall current 
is higher than the controller’s peak output current, 
you'll see ‘magic smoke’ come from the controller, 
which is bad. Another characteristic of the motor you 
need to consider is its speed: the higher the RPM of 
the motor, the faster it will turn the robot’s wheels/ 
tracks. For this robot, we’re using the micro metal 6V 
N20 motors from Pimoroni. 


MOTOR MARKINGS 
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MOTOR TYPES 


No brushes to wear out 
More torque 

More power 

Better control 
Power-to-size ratio 


Complex & expensive controls 
Less rugged 
Cost 


High torque at lower speeds 
Simple control circuits 
Cost 


Shorter operational life 
Power-to-size ratio 


Precise control 
(turns in small steps) 


Complex controls 
Cost 
Slow 


Some things you'll see on a motor... 


The rated voltage of the motor. Can also be shown 
as ‘12V DC. DC means that the motor must be 
powered by a direct current source like a battery. 


Revolutions per minute. Can also be shown as r/min. 
The lower the number, the slower the motor is, so 
500 rpm is faster than 25 rpm. 


Not pictured on this motor. If a motor output is 
described as a ratio, the lower the number, the 
faster the motor, so 50:1 is faster than 254:1. 
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CONTROLLER 


Now we have motors, we need a way to use them 


otor controllers, like the name suggests, 

are used to control motors. There are many 

types available for the Raspberry Pi, so when 
selecting the motor controller, you need to match the 
controller to your motors. An important consideration 
in this selection is the support documents, libraries, 
and software examples. Features to look out for are 
inputs, outputs, servo control, and whether or not 
it can power the Pi from a single power source. The 
controller you select must be able to handle the 
battery voltage, the peak current of the motors when 
stalled, and be compatible with the Raspberry Pi. 


TO CONSIDER: 


piborg.org/zeroborg 


The ZeroBorg is the controller we're using in this project. 

It has a number of features that make it stand out from 

some of the other boards, such as its use of two TI DVR 8833 

H-bridges which allows for independent control of up to four motors. 

This makes it good for controlling an omnidirectional robot, or two 

stepper motors. You also can add/specify a DC-to-DC converter to power 
both the motors and the attached Raspberry Pi Zero. One final feature is the 
IR receiver, so you can control your robot with an IR remote control. 


magpi.cc/ip9wGaA 


Awell-thought-out Pi Zero format controller from 4tronix, it uses the same TI 
DRV8833 motor driver H-bridge chip as the ZeroBorg. The extra inputs and outputs 
ware great for adding sensors, servos, and NeoPixels; there's even a dedicated socket 
t ® for an HC-SRO4 ultrasonic sensor! The power arrangements are very flexible, as you 
~ can drive the motors from the Pi's BV rail or from a separate power source, from 3V 
to 11V. It's also worth checking out 4tronix’s RObOHAT if you're using a full-sized Pi. 


magpi.cc/1Pk5SdN 


The Pimoroni Explorer pHAT was the first Pi Zero-format motor driver HAT, 
and is an excellent controller. It uses the T|l DVR8833 H-bridge again and has 
four 5V-tolerant digital and analogue inputs, plus four 500mA outputs. The 
various inputs give options for connecting different types of sensors, and the 
motor driver will happily drive a pair of N20 metal gear motors. For a full-sized 
Pi, use the Explorer HAT Pro. 
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POWER 


YOUR ROB 


The perfect batteries to get your 


robot moving 


he correct battery can make a huge difference 
to your robot. It all comes down to four types 
for robots: lithium-ion, NiCad-based, lead 


acid, and dry cells. Battery technology has improved a 
great deal in recent years, thanks to the development 
of mobile phones, laptop computers, and tablets, 


with their requirement for high power and increased 
standby life. Whichever battery type you use, you’ll 
need a battery holder to connect them. 


NICAD / NIMH 


(nominal cell voltage 1.2V) 


NiCad / NiMH batteries 

were the number one choice 
before the rise of the lithium- 
ion batteries, due to their 
power-to-weight ratio and a 
predictable discharge voltage 
that changes little from 1.2V 


They’ re packaged in common 
battery sizes, including AAA, 
AA, and PP3. Chargers are also 
commonly available, even 
being sold in supermarkets. 
The discharge rates are not 

as high as a lithium battery, 


but they don’t have a 
Wi Pi flammable metal in 
PICK 


their construction. 
We’re using this 
type for our robot. 
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per cell until it nearly runs out. 


LITHIUM-ION 
INCLUDING LIPO 


(nominal cell voltage 3.7V) 


Lithium-ion-based batteries 
offer some of the highest 
energy density and energy 
release available. This means a 
robot powered in this fashion 
can use a smaller, lighter 
battery. Lithium batteries 

are more dangerous, though. 
There are two types of lithium 
batteries: type one has built- 
in safety circuits, to protect 
against under- and over- 
voltage and short circuit. Type 
two batteries have no safety 
circuits! If you wish to upgrade 
your robot to LiPo, make sure 
to be safe. 


LEAD ACID 


(nominal cell voltage 2V) 


The granddaddy of all 
rechargeable batteries, the 
lead acid battery was invented 
in 1859 by Gaston Planteé. This 
type of battery has a very low 
energy density and is made 

of lead. This makes it a poor 
choice for use in a robot, 
although it can supply high 
surge currents. While larger 
lead acid batteries are used 

in most cars, they’re best 
ignored for this project due 

to their high weight and low 
energy density. 


DRY CELL 


(nominal cell voltage 1.5V) 


Zinc-carbon and alkaline 

are the more common types 

of dry cells, widely available 

in common battery sizes, 
including AAA, AA, and PP3. 
Although not rechargeable, 
they’re useful as an emergency 
replacement for NiCad / 

NiMH; however, you need to 
be careful with the increased 
voltage. They’re also expensive 
to continually replace. 
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Very small 

Very cheap 

Low power consumption 

More powerful than a Model At 


Limited USB connectivity 
Needs more soldering for GPIOs 
No on-board wireless or Bluetooth 
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The most powerful Pi 

Relatively low electricity requirement 
4* USB ports 

Wireless LAN and Bluetooth 


Higher power consumption than other Pis 
The biggest Pi 


Most expensive Pi a) 
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Low power consumption we 


Standard-size USB port 


Bigger than Pi Zero 
Only one USB port 
No on-board wireless or Bluetooth 
Least powerful Pi 
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HOW TO 


For the chassis plates, you'll have to get them 
laser-cut - or cut them out yourself - from 3mm 
plywood, MDF, or Perspex (acrylic). It's also possible 
to convert files for 3D printing. 

You can download a PDF for the plates from 
GitHub (magpi.cc/2dx82h0). You'll also find a 
DXF file, plus the original Inkscape SVG files, so 
you can modify the design if required. Your local 
makerspace, hackspace, or fab lab may be able 
to help cut the plates. In the UK, there's also Eagle 
Labs. There are other online laser cutting services 
- try searching for ‘laser cutting services’ in Google 
and look for local ones. A top tip to remember: the 
plates’ edges should be cut last on the laser cutter. 


MagPi robot chassis files: magpi.cc/2dx82hO 


Hackspaces and makerspaces: magpi.cc/2dxbnxr 
Eagle Labs: labs.uk.barclays 
Fab Labs UK: fablabsuk.co.uk 


RazorLAB: razorlab.co.uk 
Laser Make: lasermake.co.uk 
Perspex (acrylic) supplier: kitronik.co.uk 


BUILDING NI 


Get your screwdriver handy, as it’s time to make your robot 


Prepare the motors 
The motors must be modified slightly 
to make sure they fit under the 
chassis. Using a soldering iron 
and a pair of pliers, you should , 
remove the bent pins from _ 
each motor shim, suck out 
the solder, and solder 
some Straight pins 
back in. Once that’s 
done, connect the 
wheels to the motors. 


Major components: 


Attach the motors 


The motors need to be attached to the 
bottom plate using the brackets, as shown. 
You can either have the wires connected now 
ul while it’s easier to do, or you can add them 
PP3 battery clip afterwards so they’re out of the way as you 
connect the rest of the motors. 


= See 


Wom Vp ep ae a te Ne ee | i eae poe oo 
Connectors and fasteners: 


i 
ee So 


magpi.cc/2ebjlgV 
PP3 rechargeable battery 


Female-to-male jumper wires 
magpi.cc/2dvjMSb 


6x 3mm hole, 20mm length PCB 
spacer posts 
magpi.cc/2dvjKJR 


12x 3mm, 8mm length hex pan 
head machine screws 
magpi.cc/2ebkaWQ 


8x straight header pins for motors 
magpi.cc/2eeUbv9 


Jptional camera: 
Camera holder 


Raspberry Pi Camera Module 
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Tidy the wires 

Once all the motors are connected, 
flip the bottom plate the right way 
up and make sure all the wires are 
connected to the motors. You can 

push them two at a time through the 
rectangular holes on the side, which 


you’ll need to do now. eS 
Age ™ 


A little bit of soldering 

Solder the header for the ZeroBorg onto the Pi Zero. It should be 

positioned on pins one through six, as shown above. Make sure it’s 
soldered to the underside as in the picture as well! 


Make the brains ae a a= 

Attach the spacers to the ZeroBorg and then follow that up Wyyyadeee, ~ 

by placing the Pi Zero on top, making sure the header goes - 
over the relevant pins. The USB ports and HDMI port are 
on the same side as the ZeroBorg connectors — refer to the 
step 06 image, just in case. 


Construct the top part 

You can attach the power wires now if you wish — refer to step 09 

for the orientation — but either way, you need to 

then mount the ZeroBorg and Pi Zero combo to 
the top plate. It attaches to the shorter side; 
you’ll know as it’s the only spot you 
can slot in the screws. 


Check the battery wires 

If you haven’t already, connect the power wires to 
the central terminals, as shown. It’s important to do 
so in this order (positive on left, negative on right), 
otherwise you won’t be able to properly power the 
ZeroBorg, which in turn powers everything else. 


as a. - .s eae 


a i] Tee 


Connect the motor wires 
You can now Start connecting the motors to the 
ZeroBorg. Each motor has a pair of cables, and 
they should all be connected in pairs, one after 
another, in the remaining four pairs of 
ZeroBorg terminals. It’s a good idea to keep 
the right-side motors on the right and 
left-side on the left as well. It doesn’t 
matter which way around the pairs 
go in their individual terminal 
blocks, though. 


N 


Tidy the robot up 

Tidy up the wires and connect the battery; it won’t 
turn the robot on until you move the jumper to the on 
position. Connect the wireless controller’s dongle and 
you’re ready to get programming, if all you want is a 
remote-controlled robot. 
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Install ZeroBorg software C O NIR O i rR O M 


Now you need to download the ZeroBorg software. 
Open a terminal window and enter the following: 


Control your robot from your computer or 


Smartphone and use the on board camera 
You should also install the joystick app for testing 
your joypad and mapping the buttons. See the ‘Using 
a gamepad’ section (bottom right) for more details. 
The button mapping for the game controller is in 
zbJoystick.py. Use nano to open the file, and find the 


For this way of controlling the robot, you’ll have to switch out 
any game controller receiver for a WiFi adapter. Plug the Pi Zero 
into a computer and get the WiFi connected before continuing. 


Once that’s done, you need to find the IP address of the 


robot by opening a terminal window and using: 
line # Settings for the joystick. For the Rock 


Candy controllers used in our version, it should look 
something like this: 


Make a note of it — this is how we’ll connect to the robot 
from elsewhere. Then install OpenCV using: 


Once that’s done, you’ll need to download the PiBorg web 
interface. Back in the terminal window, use: 


This will create a folder called diddyborg-web. Enter the 
following commands to start the web server: 


It will confirm when the web server has started. Type the 
IP address you found earlier into a browser on your PC or 
smartphone (or even another Raspberry Pi!) and you’ll be able 
to connect to the robot and see through the camera. Disconnect 
the monitor and any peripherals, then go for a ride! 


To get the gamepad or joystick button numbers, 
install the joystick software with: 


Plug your gamepad in and then run the 
following to find out how it's listed: 


It will probably come up as something like 
/dev/input/jso. You can then test it using: 


Move each stick and press each button in turn. You will see the values 


change for the axis or button pressed in real-time. Make some notes so you 
remember which button is which! 
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Nex ISSUE. 


Come back next issue to learn how to add and use sensors 


to your robot to make it a true automaton 


conquer these challenges. 


The Straight-Line Speed Test is autonomous, 

with only a start and stop button allowed for the 
starting and stopping of your robot’s run. The 
course is a Straight run, just over 7.3m long, with 
walls 67mm high placed 522mm apart — very 
precisely. There are penalties if your robot touches 
a Wall, plus points for each clean and completed 
run. Three runs must be attempted. Here are some 
methods you could use for this challenge... 


Novembe 6 


i Wars is next April and has a load of different 
challenges; it’s a bit too late to enter them, 
but that doesn’t stop you from learning how 
to get your robot competition-ready by using some 
excellent robo-sensors. Come back next month for 
our guide on how to add and use amazing sensors to 


Find the walls and guide 
your robot down the centre. You could also 
use an IR light beacon placed at the end of 
the course and aim to keep the beacon in th 


centre of the image, while steering the robot 


down the centre of the course. 


Count the number of turns each wheel make 
in a set time. The shorter the time, the more 
accurate it should be. 


Measuring the distance 
between the walls, steer the robot down the 
centre of the course. 


Set a bearing and follow it - distance 
sensors may be useful as a backup check. 


c 


S 
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The Minimal Maze is new to the Pi Wars contest, and it is an 
autonomous event. It’s basically two right turns followed by 
two left turns in a course with 65mm-high walls. Additional 
points will be given for clean runs where the robot does not 
touch the walls, along with points for a completed run. 

Penalties are given for touching walls, rescue attempts, 
and non-completed runs. As the measurements for the maze 
are not given, it will not be possible to use dead reckoning 
to navigate the maze, so the challenge requires the use of 
sensors. Not counting access to a lidar (a laser radar!), we 
have a number of sensors at our disposal. 

You could use the Pi Camera Module and OpenCV to find 
the positions of the walls or determine their colour. The 
walls are colour-coded to their orientation, so you will be 
able to tell which way your robot is facing. 

It may be a good idea to use distance sensors to avoid hitting 
the walls. Another method would to drive forward until you 
are a set distance away from the wall, then turn 90 degrees, 
either clockwise or anticlockwise depending on whether you 
need to turn left or right, repeat until last turn, then drive 
forward to the exit. The use of wheel/motor encoders and an 
IMU may help. If you use the data from your first run, it may 
be possible to improve your next run’s time. 
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FREE 


Subscribe in print for six or 12 months to receive this stunning free gift 


Subscribe today & receive: 
A free Pi Zero v1.3 (the latest model) 
A free Camera Module connector 
A free USB & HDMI cable bundle 


Delivered with your first issue! 


Other benefits: 


Save up to 25% on the price 
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Sadly, the pieces have yet 
to crush their opponents, 
as they do in the book 


Motors on an x- and y-axis 
select the appropriate 
piece to move 


Quick 
Facts 


» Watch the 
set in action 
at youtu.be/ 
Z7xdFn5bVrA 


» The Wizard 
Chess Tour 
started in 
Harlow 


» After Harlow, 
it visited the 
Covent Garden 
Raspberry Jam 


» Inspiration 
came from 
Instructables 
user maxjus at 
magpi.cc/ 
2cnyoBo 


» It's wingardium 
leviOsa, not 
leviosAH 
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Etched acrylic allows 
magnets to move the 
pieces from beneath 
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19-year-old Bethanie Fentiman shocked her A-level classmates when she 
rocked up with a fully working Harry Potter Wizard’s Chess set as her final 


coursework assignment 


ethanie Fentiman can’t 

play chess, but when her 

imagination sparked and 
the opportunity presented itself, she 
brought the iconic game of Wizard’s 
Chess from Harry Potter to life using 
a Raspberry Pi, stepper motors, and 
possibly a little magic. 

For her A-level computing 
coursework, Bethanie took an idea 
that had been nestling in the back 
of her mind, and turned it into a 
reality. Well, as much of a reality 


The open sides of the build allow for an 
interesting view of the working mechanism 
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one can create when the literary 
version includes battling chess 
pieces that leave their opponents 
crushed to rubble on the board. 
Luckily for Bethanie, she’s a 
self-proclaimed Jambassador, 
actively participating in the 
Raspberry Pi scene via the Kent 
Raspberry Jam. With a community 
of makers to support her, Bethanie 
knew that she could complete the 
build and got to work, researching 
similar projects online that used 
magnets and motors to ‘magically’ 
move chess pieces on a board. 
After an internet search for 
inspiration, she came across 
an Instructables build for an 
Arduino- powered chess- playing 
robot by user maxjus, and used 
the main concept as the basis for 
her build. The guide provided all 
the information Bethanie needed 
to build the physical structure of 
the board, allowing for drawer 


runners, gears and, of course, 

the electromagnet that would 
move each piece when required. 

A 4tronix PiStep board, along with 
two 28BYJ-48 stepper motors, took 
up the job of moving the runners 
and electromagnet into place, 
linked through to the Raspberry Pi. 

As mentioned previously, 
Bethanie didn’t actually know how 
to play chess. So when it came to 
inputting the legal movements of 
each piece, she had two options: 
learn fast, or cheat a bit. Opting 
for the latter due to the time 
constraints of her coursework 
deadlines, Bethanie researched all 
the possible moves of each chess 
piece and worked them into the 
code. She could always learn to 
play the game later on. 

A second issue, and one far 
more associated with the original 
material from which she was 
taking her inspiration, was what 
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WIZARD CHESS 


Projects 


YOU'RE A (CHESS) 
WIZARD, HARRY 


oe AS bree ~ SZ —s 
“G = hy | % a= 
me OM VA = 


>STEP-01 


With so many new skills required, 
Bethanie thanks Ed Bye for helping 
her with the electrics of the build 


When I turned up with the fully 


moving and playable board at 


school, they were shocked 


the pieces would do as they ‘took’ 
an opponent. In the book, each 
piece defeats its foes through 
‘barbaric’ means. In reality, 
Bethanie plans on an upgrade 

to allow for movement around 
(CSS... LOU OMNES Sie Gens Ine 
belated invitation to Hogwarts, 
we’re sure she’ incorporate the 
expected level of brutality. 

With the build complete and 
presented to her computing 
A-level class, Bethanie’s Wizard 
Chess was met with amazement. 

“When I said I was going to make 
it, they just thought I was going to 
write the code and come up with 
designs for the board. So when I 
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turned up with the board at school, 
fully moving and playable, they 
were slightly shocked.” 

And they weren’t the only 
ones. Upon finishing her board, 
Bethanie took it to the Kent 
Raspberry Jam, where Twitter 
soon exploded with praise. From 
the Jam, ‘The Wizard Chess Tour’ 
was born as Bethany and fellow 
Jam members took to the road and 
presented the project at Jams in 
both Harlow and Covent Garden. 

Now actively seeking an 
apprentice in the field, Bethanie 
plans on upgrading the build while 
continuing the Wizard Chess Tour 
at more Jams in the future. 


>STEP-02 


>STEP-03 
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Quick 
Facts 


» The LEGO 
contraption 
took around 
three evenings 
to build 


» Joon's young 
daughter 
added some 
extra blocks 


» The hammers 
are made from 
coffee stirrers 
and LEGO 


» APi 3 runs 
the Python 
sequencing 
software 


» The project 
took around 
two months 
to perfect 


A music box featuring old and new technology in perfect harmony 


ith hammers hitting the 

bars of a toy glockenspiel 

Uo) jelleny al ulin. ne 
Monomepi sounds just like an 
old-fashioned music box, but this 
Pi-powered contraption is based 
on new technology... and on quite 
a lot of LEGO. “It was just my luck 
that the components fitted with 
the LEGO bricks almost perfectly!” 
reveals its creator, Joon Guillen. 


Driven by the servos, the hammers 
hit the bars of the glockenspiel to 
play the sequenced tune 


34 | MdgPi November 2016 


He got the idea after seeing a 
couple of videos of Arduino-based 
music boxes a few years ago, while 
working on a Conway’s Game of Life 
Pi project using a Monome Grid, a 
versatile piece of hardware that can 
be used to control music and more. 
For the Monomepi, the Monome 
is connected to a Raspberry Pi 3 
running a step Sequencer program, 
which registers the user’s button 


presses on the Monome and 

lights them up accordingly. The 

Pi then sends serial commands 

to an Arduino Uno connected via 

a ProtoShield kit to eight servo 
motors, which move makeshift 
hammers to play glockenspiel notes 
to match the pattern shown on the 
Monome. On the latter, the user can 
switch buttons on and off to alter 
the sequence as it plays. 


The user presses light-up 
buttons on the Monome 
Grid step sequencer to 
program a tune 


While the Pi is the brains of the 
setup, an Arduino is used to 
control eight servos attached 
to makeshift hammers 
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The note-playing hammers are made from coffee stirrers 
stuck to LEGO blocks snaffled from Joon’s toddler! 


“The contraption itself took 
only two or three evenings to 
build,” Joon tells us. “I focused 
most of my energy on the software 
Side, so the physical construction 
was almost an afterthought.” 

To build it, he borrowed a bunch 
of LEGO blocks from his young 
daughter. “They were the first 
things I thought of using. I 
haven’t the talent for crafts, 

and so LEGO was the quickest 
way to build the contraption. My 
daughter even added some blocks 
of her own in there!” 

While the construction was quick, 
the project as a whole took around 
two months, with Joon working 
casually over the course of several 
evenings and weekends. “Most of it 
was figuring out the step sequencer 
logic, Arduino code, and optimising 
performance.” The main Python 
program running on the Pi is 
based on a Monome library Joon 
had created for his previous project. 
“That took a very long time, as I 
had zero Python knowledge when 


a 
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I started out. The library has since 


undergone several improvements 
through the years.” 

While Joon opted to control his 
Servos via an Arduino, he says 
there’s no reason why anyone 
creating a similar project couldn’t 
trigger them from the Pi itself, 
using a suitable motor driver board. 
And if you’re lacking a Monome 
(quite an expensive piece of kit), a 
touchscreen could be used instead: 
“A web-based UI should work, too. 
Or, if one isn’t necessarily trying 
to make a step sequencer, push 
buttons or [a computer] keyboard 
are viable control alternatives.” 

As a part-time musician, Joon 
plans to sample the Monomepi to 
use in at least one of his tracks. 
He’s also looking to improve the 
project by “adding features to the 
step sequencer program, such 
as having more than 16 steps, 
and the ability to use multiple 
velocities. Other than that, | am 
trying to think of more ways to 
use my servos with the Pi!” 


— 


Joon admits he was lucky that the servos 


fitted easily between the LEGO blocks, 
albeit with a bit of paper padding 
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» Pianolas were 
first developed 
in the late 
19th and early 
2oth centuries 


» Original pianolas 
used bellows to 
push down keys 
with air 


» The keys in 
this pianola are 
pushed using 
electromagnets 


» It can play songs 
backwards 


» Lloyd originally 
used aplaymidi 
from the 
command line 


The touchscreen display enables 
users to control the Raspberry Pi 
and select MIDI tracks 


The MIDI file is used by the pianola 
to determine which keys to play 


A USB-to-MIDI cable is used to 
connect the Raspberry Pi to the 
Yamaha Disklavier’s MIDI IN socket 


When one maker’s self-playing piano failed, he used a Raspberry Pi 
to repair it... and made it his pianola play even better than before 


ve always wanted an 

pianola,” says Lloyd 

Bayley, the owner of this 
rather fantastic Yamaha Disklavier 
self-playing piano. 

Pianolas may look like regular 
instruments, but they don’t just 
make the sound of a piano. They also 
move the keys all by themselves. 

Self-playing pianos have a long 
and distinguished history. “I was 
around the old paper roll, bellows- 
driven ones when I was a child,” 
Lloyd reminisces, “and I found 
them fascinating. I found this one 
at a Sydney piano shop and went 
to visit them for a demonstration 
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and decided to buy it on the 
spot... I’m still enjoying it after 
almost three years.” 

Pianolas are spectacular to 
watch. Classic versions were 
controlled by reams of paper with 
holes punched into them. You can 
see self-playing pianos in classic 
movies (particularly westerns 
and comedies). Modern pianolas 
have replaced the paper rolls with 
floppy disks and MIDI files. 

“The piano itself doesn’t store 
songs,” explains Lloyd, “as it has 
no on-board memory. Everything 
must be loaded via floppy drive or 
via the MIDI ports.” 


The electronic system uses 
programming to fire solenoids, 
“which are a bit like a little finger 
that prods the hammers to strike 
the strings,” says Lloyd. “The 
strike force can be varied, and 
they are thus able to play loud and 
soft notes with ease.” 

Lloyd’s Yamaha Disklavier 
eventually suffered a hardware 
fault. The 3.5-inch floppy drive, 
which was used to load the 
music files, stopped working. 
Rather than pay for an expensive 
replacement from Yamaha, he 
chose to use a Raspberry Pi with 
a touchscreen display instead. 
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The Raspberry Pi attaches to the 
back of the touchscreen with pre- 
installed mounting accessories. 
“To connect it to the pianola, | 
Hse sb aOn UO leone mien 
cable and was a little surprised to 
find it was that simple.” 

Lloyd loaded the Raspbian Jessie 
operating system and tried to 
play a file on the command line 
with the aplaymidi utility. “I was 
going to write my own cataloguing 
and playing software and while 
researching it, I came across 
XPMIDI (magpi.cc/2cCfG9L), 


It was quite an easy project, 
as most of the ‘trickery’ 
is already in place 


which does the job nicely. It has 
a GNU public licence, so you can 
modify it if need be.” 

The end result is a fully working, 
self-playing piano which is a vast 
improvement upon the original 
version. Lloyd is able to store far 
more songs, and a program that 
he developed for the touchscreen 
enables rapid access to his choice 
of a list of thousands of songs. 
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“It’s working and working 
well,” says Lloyd. “I have a few 
different playlists that I favour, 
and I also like to play manually as 
well. It’s a nice happy pianola to 
have around the house. 

“T have showed it to people and 
they are amazed, and think I’m 
very clever. However, it was quite 
an easy project, as most of the 
‘trickery’ is already in place. 

] just had to fit all the pieces 
of the puzzle together.” 

Lloyd tells us that his pianola 
project is mostly complete. 
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“T think I would like to have a crack 
at doing the reverse, so I could 

play straight into the storage on 
the Raspberry Pi.” This is a feature 
built into the pianola, but it writes 
directly to the floppy disk. 

“With a bit of extra software,” 
says Lloyd, “you could output 
through the MIDI ports back in. T 
That will take a little research and 
is on the list of things to do.” 


a 


— . we 
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he pianola is quite mesmerising to watch, 
nd plays songs with precision and perfection 


he Disklavier script launches the 
interfaces, enabling users to select 
songs via the touchscreen 
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Projects 


TEEFAX 


PETER KWAN 


Having worked as an engineer with 

teletext equipment for the last 12 years 
it was transmitted in the UK, Peter is an 
expert in the field. When not recreating 
teletext, he’s out riding his bike through 


the valleys of Stroud. 


teastop.co.uk/teletext 


Teletext makes a comeback with the help of the Raspberry Pi 


Peter built a 
text service 
for the Stroud 
Fringe festival 


New Teefax 
contributors 
are always 
welcome 


You can use 
Peter's wxTED 
page editor 
(magpi.cc/ 
2dsEZfG) 


Dave Honess 
has made a 
teletext QR 
code generator 


Peter is 
developing 

a Muttlee 
multi-user live 
editing system 


efore the dawn of the 
world wide web, teletext 
was the best way of 
keeping up to date with the latest 
news, sports scores and other 
information. The BBC’s Ceefax 
teletext service continued in the 
UK right up until analogue TV 
transmissions ceased in October 
2012. We still miss its no-nonsense 
approach and blocky graphics, 

so we’re delighted that teletext 
has been revived by the Teefax 
project. Users can install the free 


Teefax project founder 
Peter Kwan is a former 
teletext engineer 


To control the service, just use 
the teletext buttons on your 
TV remote, as usual 


100 Teefax 100 Fri 12 Aug 07:39/11 


STROUD BAMBOOZLE 152 
EX. Sos 


OREGON TRAIL.... 


REMEMBER TO . 
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software (magpi.cc/2dssVeo) on 

a Raspberry Pi, connect its 3.5mm 

video output to a TV (via the SCART 

socket), then hit the teletext 

DultIonM on the remore control: 
Project founder Peter Kwan is 

a former teletext engineer who 

carried on working in the field 

as a hobby. “As the analogue TV 

network was being shut down, 

I was thinking 

about how I could 

generate my own 

teletext,” he 


recalls. With the idea of making 

a low-cost basic teletext inserter, 
Peter manufactured his own VBIT 
hardware and managed to geta 
Tull teletext service running on it. 
Initially, there was a practical use 
for the system. “There is a lot of 
hidden signalling in the teletext 
signal,” Peter reveals. “The BBC 
uses a system called Presfax which 


hides schedule information in 
databroadcast packets. They also 
*\ have special signals that let 

\ London take over the whole 


The data transmitted via the 
Pi's composite video signal is 
converted into teletext pages 
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sooo! 


VBIT-PI 519 Wed OS Oct 11: 50/13 


“+ HRIRERTERS! 2: 


Hair... 
here, 
hold: 


excess of domestic hair... 


ME 


it is modern problem. 


hair there - hair nal og By fcrdagga ml 
ow there is solution oO 
oe a HAIREATERS! 


Hair 
But 


| 


. %* Your hand/plate 


* Bath hole * Rear of husband K Cat’s 
stomach * Sofa *% Dofa”? *x Other holes 
MUNCHMUNCHMUNCHMUNCHMUNCHMUNCHMUNCH |! 


DISCLAIMER: Our hair- 
really like eating hair, 


eating specialists 


but we cannot 


responsible for anything else 
Oe ant Pig They’re a bit funny in 


the head, 


and one of them once did a 


big blow off in a customers’s mouth. 


Along with news, Teefax pages include teletext art, quizzes, and some humorous 


articles from the likes of Mr Biffo 


network in an emergency.” In 
addition, betting chains use control 
signals to switch TV channels or 
mute audio in their shops, while 
European broadcasters use opt- 
out signals to insert local adverts. 
“These all need testing and VBIT 
was a low-cost and flexible way of 
eenerating these signals.” 

When the Raspberry Pi was 
launched in 2012, Peter soon 
realised it could be used instead of 
his bespoke hardware. “It had [?C, 
SPI, and GPIOs to drive and it was 
cheaper than the AVR boards that | 
was using, so I hooked one up and 
it worked. I made a second spin of 
the board and called it VBIT-Pi.” 

The next big breakthrough came 
when Alistair Buxton managed 
to create a teletext signal direct 
from the video output of the Pi. “I 
bypassed the teletext stream from 
my hardware to Alistair’s software 
and instantly halved the cost of a 
teletext system,” says Peter. “The 


only thing that the Pi can’t do is 
overlaying from video, so things 
like subtitles and newsflash need 
an original hardware VBIT.” 

The Teefax server is actually 
an original Pi Model B running 
Subversion. “Apache handles 
user authentication. PHP scripts 
triggered by Cron scrape the BBC 
News website and update the news 
pages every day.” Currently, there 
are seven authorised contributors 
to Teefax. “The real number is more 
because people are welcome to 
submit their own pages and designs 
and we will put them into Teefax for 
them.” To do so, you can use Peter’s 
WXTED page editor on a PC. 

Meanwhile, Peter is currently 
working on a more flexible version 
of the VBIT system with a much 
faster update speed. “This actually 
has acommercial application in 
the betting industry where a small 
delay in reporting the ‘off’ ina 
horse race can be costly.” 
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pi-topCEED 


Viewing Angles 


14” 
HD Screen 


Modular 
Components 


$41499 


without Raspberry Pi 
ex VAT 


pi-top 


10 Hour 
Battery Life 


3.3" 
HD Screen 


Modular 
Components 


$264% 


without Raspberry Pi 
ex VAT 


Available in green or grey colours 


@ 
i-to Worldwide shipping available in green or grey at www.pi-top.com 
Stay up to date with our latest news by following our social media 


CEEDuniverse 


CEEDuniverse is a world of fantasy 
grounded in computing reality! After 
crash landing on a strange new planet 
you will first encounter ‘drag and drop’ 
coding puzzles that improve your 
computational thinking skills. 


Discover more about the planet you've 
landed on and the civilisation that used 
to inhabit it while learning harder and 
more complex concepts in fun and 
engaging ways! Before long you'll be 
writing your own conditional 
statements, loops and functions. Find 
out more about CEEDuniverse at 
www.pi-top.com 


pi-topCODER 


Influenced by the workflow of makers 
and hackers, pi-top presents 
pi-topCODER - an integrated code editor 
which allows you to learn, write and test 
code all in one view. With intuitive 
syntax highlighting, dynamic views and 
customizable themes it makes for a 
versatile learning tool for your projects. 


pi-topCODER also has every Raspberry Pi 
Foundation lesson plan created and will 
track and save your progress as you go 
through dozens of fun hardware and 
software projects. 


‘q ‘X 
pi-topPROTO pi-topSPEAKER 
pi-topPROTO is a HAT compatible Give a voice to your pi-top device 
Add-on Board for your pi-top or with pi-topSPEAKER! 
pi-topCEED that allows you to 
prototype electronics. Create a ¢ Modular design, attach up to three 
Weather Station, HAM Radio, Heart in a row to give true stereo sound. 
Rate Monitor, or integrate any e 2W per module 
Arduino based maker kits into your e Left, Right and Mono mix selection 
own Raspberry Pi compatible e High quality SPDIF digital audio 
prototyping board! from HDMI 


e IC controlled - 


Our Official 3. _ @Qll oe we 
Distributors adafruit > SCIENCE KIWI @electronics @¢ KUBii MODMYPI _ Mllcio cences B PrSnor.cu RS Sparkfun. | 


The easiest way to set up a Raspberry Pi with Raspbian, 
and other operating systems, is to use the NOOBS installer 


NOOBS V1.9 - Built: Mar 18 2016 
J @ 


Edit config (e) Wifinetworks (w) Online help (h) — Exit (Esc) 


Raspbian [RECOMMENDED] q 
A community-created port of Debian jessie for the Raspberry Pi — 


> LibreELEC_RPI2 | 
> LibreELEC is a fast and user-friendly Kodi Entertainment Center distribution. ” 


} Raspbian Lite : 
A community-created port of Debian jessie for the Raspberry Pi (minimal verso 


Data Partition 
Adds an empty 512MB ext4 format partition to the partition layout. 


a. 


OSMC_Pi2 
A fast and feature filled open source media center 


Windows 10 loT Core 
Windows for devices. Enables you to build projects and apps. 


[4 | 


Disk space 


Needed: 3944 MB 
Available: 6411 MB 
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Learn your way around the configuration tool found in Raspbian Jessie 


§ > Raspberry Pi 


 Raspbian Jessie oe eee | | ce eae | ie 


= with PIXEL j ACCESS 


_System | . 
é : Options to expand the file system and change password 
Filesystem: and hostname sit alongside various login choices. 


Password: ‘Change Password... terface 

Host : Support for the various hardware and software 
Los i ae features, such as Camera Module, SSH, and VNC. 

Boot: © To Desktop © To CLI 7 | 

Auto Login: 4 Login as user ‘pi Overclocking and GPU memory options can improve 

: | | the performance of a Raspberry Pi. 

Network at Boot: _J Wait for network 

Underscan: © Enabled © Disabled 


olisati 
Set up an international keyboard, global WiFi options, 
and adjust the locale and time zone. 


Rastrack: 
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The stage is the same 
as before, and you can 


Create your code in this 


maximise it by clicking 
the blue square icon 


space and make your 
wildest dreams a reality 


‘st ep at my Pity Tin 


Save and load your 


projects, just as you 
could previously 


Follow theta tutonals to get started with your 
proqanct. 


CRAICH 20 


ON RASPBERRY PI 


Get access to the upgrade for Scratch 
via some very easy steps 


cratch is an amazing piece of software that 
has helped many people take their first steps 
into the world of coding. We’ve done a fair few 
Scratch tutorials ourselves on the Raspberry Pi, but 
they always use Scratch 1.4, which is installed on the 
Raspberry Pi itself. 

Thanks to the recent updates to Raspbian with 
PIXEL, the official Raspberry Pi operating system, you 
can finally upgrade to the latest version of Scratch. 
It’s very easy to do as well, so get your Raspberry Pi 
out and let’s begin. 


>STEP-01 

Upgrade Raspbian 

You’ll need to do this in one of two ways: upgrading 
from a previous install, or downloading the latest 
release of Raspbian with PIXEL (magpi.cc/2ejN6sk) 
and writing it toa new SD card. 


Raspberry Pi 3 
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on your Raspberry Pi 


To upgrade from an earlier version of Raspbian 
to Raspbian PIXEL, open up the terminal and type 
the following: 


sudo apt-get update 
sudo apt-get dist-upgrade 


This may take a while and will probably require a 
reboot once you’re done. You’1] then be in the latest 
version of Raspbian with the PIXEL desktop. 


>STEP-02 

Update your Raspberry Pi 

The ability to use Scratch 2.0 is tied to the new 
browser, Chromium, being able to use Adobe Flash. 
This isn’t installed as standard with PIXEL, so you’ ll 
need to update to get the Flash library. If you dida 
dist-upgrade to get PIXEL, then you may be able to 
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skip this step. Otherwise, close Chromium if you have 
it open, go to the terminal, and enter the following: 


sudo apt-get update 
sudo apt-get upgrade 


At some point during the upgrade process, you’ ll 
be asked in the terminal window if you want to install 
Flash; just press ENTER to accept. Once everything is 
updated, you’re ready to go. 


Find Scratch 2.0 

Scratch 2.0 is not a program you can install on your 

Raspberry Pi, but instead is an online editor you can 
use through the Chromium browser. This is good, as 
it means you can use Scratch anywhere, taking your 


projects easily between computers. It also means your 
old Scratch projects for Scratch 1.4 on the Raspberry Pi 


will still work on that version installed on the Pi. 
Open up the Chromium browser and head to the 
following address: scratch.mit.edu. 


Browsing the website 
From the main page, you can head straight to the 
editor by clicking the Create button at the top-left of 
the screen, or you can browse some examples if you 
want something more than just a blank canvas. There 
are also Some games and programs that have been 
uploaded onto the website by other users to try out. 
Once you click through to anything, though, you’ Il 
need to right-click on the puzzle piece on the screen 
and then select ‘Run this plug-in’ for Flash to start 


working. It might take a moment to load the interface. 


Make something 
Scratch 2.0 works in mostly the same way as Scratch 
1.4, although there are some extra features you can 
make use of. As before, you place blocks to create 
code with loops, variables, and triggers. You can also 
upload sprites and music from your computer if you 
want to use more than just the defaults available. You 
can then save your files to your Raspberry Pi by going 
to File and then ‘Download to your computer’. 

You’ ll also notice an ‘Upload from your computer’ 
option; this can be used to load the files you make 
in Scratch 2.0, and upload some of your Scratch 1.4 
projects as well. 


Compatibility 

Scratch 2.0 projects can sometimes have a hard time 
working on the version of Scratch that’s installed 

on the Raspberry Pi. As long as you have an internet 
connection, it shouldn’t be a problem, as you can run 
them in the browser. If you want to convert the files 
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Updating your Raspberry Pi is essential 
- make sure you do it regularly 


Contiguring rpi-chromium-mods -———————} 


/ 
Adobe Flash Player. Copyright 1996-2015. Adobe Systems Incorporated. All 
Rights Reserved. 


| 
Adobe and Flash are either trademarks or registered trademarks in the ) 
: United States and/or other countries. ) 
OK] 


This screen will show up during 
the upgrade process - just press 
ENTER to install Flash 


'LEARN TO 
If you want to get stuck in with | fal 
Scratch and make some cool stuff, COP) 
you should check out our Scratch WITH 
Essentials book, Learn to Code with 
Scratch. While it's written for Scratch 


1.4 on the Raspberry Pi, the projects 


should mostly work on 2.0 on the 


web as well. You can find the free 
PDF, along with other ways to get it, 
here: magpi.cc/Scratch-book 


to work offline in Scratch 1.4, you can try out the Retro 
Converter here: magpi.cc/2dtEUYW. 

It’s not perfect, though, so you may need to make 
some tweaks once you’ve done the conversion to get 
it working properly on the older version of Scratch. 
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THE HAYLER-GOODALLS 


Ozzy, Jasper, and Richard are mentors 
at CoderDojo Ham and gave a talk at 
the Raspberry Pi birthday party about 
their AstroPi adventures. 

magpi.cc /1lLmeoi 

@rdhayler / coderdojoham.org 


If you use a Pi Zero, 
you'll need a USB shim 
for the WiFi dongle 


The Zero LiPo board 
fits neatly under the 
Enviro pHAT 


Explore the underwater world with a Raspberry Pi camera 


here are plenty of underwater sports cameras 


available, but they can be quite expensive, Find a suitable container 

eee especially if you want to control them remotely. This needs to be watertight and have at least a see- 
waterproof box In this tutorial we’re going to use readily available Pi through lid. You can find Tupperware boxes with a very 
magpi.cc/ add-ons to make a cheaper, customisable camera unit. tight seal, but these tend to be translucent rather than 
See There are lots of options and alternative sources of transparent. The size of box will probably determine 

> Pi Camera components for a project like this. For example, the your choice of Pi and power source. Zeros are great as 
Mite MS Pimoroni Enviro pHAT is a really useful option that they’re so small, but then you’!l need a WiFi dongle and 

> Portable power can report back information about the environment shim. You can also save space by using a LiPo battery 
setnnes in which the camera is operating, especially how instead of a power bank, although you’!l need a boost 

> hostapd and much light is available. There’s a fair bit of software regulator too, such as the Pimoroni Zero LiPo. 


dnsmasq 


eee configuration involved, but example config files are in 


the GitHub repo for this article (magpi.cc/2e8dtFk). 
> Python Flask 


ee Configure your Pi to be a WiFi access point 


SE ‘ Start from a fresh Raspbian Jessie Lite SD card and 
- aw l install the following: 
Ata Ny ' sudo apt-get update 
| 7 sudo apt-get install -y dnsmasq hostapd python3 
python3-dev python3-flask python3-picamera 


> WiFi dongle 
(if not using 
a Pi 3) 


> Enviro pHAT 
(optional) 
magpi.cc/ 
29NHB3T 


> ZeroView 
(optional) 
magpi.cc/ 
2e89hWt 


First, configure your wireless interface to have a 
static IP address by editing /etc/network/interfaces. 
Then set it to not use DHCP by adding this line: 


denyinterfaces wlan@g 
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...to the end of your /etc/dhcpcd.conf file. Next, 
create the /etc/hostapd/hostapd.conf file, using the 
example in this tutorial’s GitHub repository as 

a template. Change the interface, ssid, and 
passphrase parameters as needed. Finally, edit /etc/ 
dnsmasq.conf, ensuring that the IP addresses are 
consistent with your settings in 
/etc/network/interfaces. Then reboot! 


>STEP-03 
Add the Enviro pHAT 

You have the option of soldering this board directly 
onto the Pi’s GPIO pins, or you can use the supplied 
female header if you want to reuse it in other projects. 
After that, install the Python library and dependencies 
using the following command: 


curl -sS https://get.pimoroni.com/envirophat | bash 


The library comes with some example programs 
and you should run these to test that everything 
is working correctly. 


>STEP-04 

Fit everything into your container 

To cut down on reflections and get the best possible 
images, the camera should be as close to the 
transparent side of your container as possible. The 
ZeroView from the Pi Hut is a clever mounting plate 
that uses suction cups and will also hold your Pi 
securely. Alternatively, you could make a mount 
out of cardboard and glue this to the inside of the 
container. Velcro tape can be a good solution for 
power sources (which normally need to be removable 
for recharging). 
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AQUAPI-CAM 


You'll still have to get pretty close to the water yourself 


The web interface shows environmental information 
and lets you control the camera 


>STEP-05 

Add some code, HTML and CSS 

Clone the entire Flask folder from the project 
repository onto your Pi. Flask is a small web 
framework written in Python which allows you to 
create simple web services; in this case, it’s a webpage 
that allows us to see data from the Enviro pHAT 

and the latest captured images. We can also switch 
between recording modes (movie or continuous still 
frames) or take photos on demand. This control of the 
camera is achieved via the excellent Python picamera 
library. You could enhance the project by adding 
additional exposure and shutter speed controls to 
your interface if you want. 


>STEP-06 

Set the code to run at boot 

To set the AquaPiCam program to run when the 
Pi boots up, add this line to your /etc/rc.local file, 
immediately above the exit @ line: 


python3 /home/pi/Flask/apc.py & 


It’s also a good idea to configure the Pi to only boot 
to the command line, using: 


sudo raspi-config 


...and selecting ‘console’ under option 3. 

Now go and find somewhere wet! You might 
want to run a few tests in the bath before venturing 
further afield! 


QuickSnap Take 
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B ven a9) = = Q “point c - shome/pi " HB pi@raspbeny: ~ 


@ Pp 


Wastebasket 


A declaration for a pointer to an 
integer variable —- in effect, an 
address containing an integer 


rT 


i.¢ Cosarch yer ovate? Orewa lel ful oc ale 
t Search View Document Project Build Tools Help 


3% @ ~ - 


clude <stdio.h> 
void main (void) 


int 4; 
int *ptr_to_a; 


ptr_to_a = &a: 


4= %; 
ll printf (‘The value of a is ‘din’, a); 


i3 *ptr_to_a = 6; 
14 printf (*The value ot 2 is d\n", @); 


16 printf (‘The value of ptr to # is Sd\n", ptr_to_a); 
i7 printf (*it stores the value %d\n", *ptr_to_a); 
18 printf ("The address of a is W\n", 6a); 
19 } 
20 
10:25:42: File (nome/pi/sum.c saved 
MOD mode Unix(LF) encoding: UTF-8 filetype C 


An assignment of a pointer 
- initialises the pointer to 
point at a specific variable 


= pPi@raspherry; ~ j 


e Edit Tabs Help 


AN INTRODUCTION TO C 


POINTERS 


Pointers: variables have addresses as well as names... 


* AND & 


When first 
learning about 
pointers, you 
may find it 
helpful to say 
out loud what 
a line of code 

is doing: an * is 
“what is pointed 
to by”, and an & 
is “the address 
of”. Once you 
have got those 
two ideas 

fixed in your 
head, you've 
pretty much 
understood 
pointers! 


he term ‘pointer’ has struck fear into the 
heart of many a beginner C programmer, but 
once you’ve got your head around them, they 
are avery useful feature of the language. They aren’t 
actually that complicated in reality. 

Remember when we looked at the declaration of 
variables Declaring a variable — telling the compiler 
what type it is and what it’s called — before you can 
use it is necessary in C, because the declaration 
enables the compiler to allocate a block of memory 
to store the variable. So for every variable you 
declare, there’s a block of memory which is set aside 
by the compiler for that variable, and the compiler 
remembers which particular block of memory is used 
for each variable. 


What is a pointer? 

A pointer is just the address of a block of memory 
with a variable in it — that’s all there is to it. So 

if you declare a variable and a pointer to that 
variable, you can access the value in that block of 
memory in two ways: either with the variable name, 
or with the pointer. 
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Let’s look at a simple example: 


#include <stdio.h> 
void main (void) 
{ 
int a; 
int *ptr_to_a; 
ptr_to_a = &a; 
a= 5; 
printf ("The value of a is %d\n", a); 
*ptr_to_a = 6; 
printf ("The value of a is %d\n", a); 
printf ("The value of ptr_to_a is 
”d\n", ptr_to a); 
printf ("It stores the value %d\n", 
*ptr_to_a); 
printf ("The address of a is %d\n", 
&a) 5 


Taking it line by line, the first line is one we’re 
already familiar with: we declare an integer variable 
called a. But what’s this? 
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int *ptr_to_a; 


This looks like it’s declaring another integer 
variable, doesn’t it? But look more carefully: the 
asterisk (*) at the start of the variable name indicates 
that this isn’t declaring an integer variable, but a 
pointer to an integer variable. 

So we now have an integer variable called a, and we 
have a pointer to an integer variable, called ptr_to_a. 
But neither of these actually have a value in them yet. 
It’s all very well calling the pointer ptr_to_a, but it 
has no idea what (or where) a is, so let’s fix that: 


ptr_to_a = &a; 


This is the important bit! In C, the symbol & before 
a variable name means ‘address of the variable’, so 
&a means ‘the address in memory of the variable a’. 
And as we Said above, a pointer is the address of a 
variable. So this line initialises ptr_to_a to be the 
address of a; ptr_to_a is now a valid pointer to the 
variable a, so we can now use it. 

The next two lines are familiar; we set a to be 5, and 
just to check that worked, we print its value. So let’s 
try doing the same thing, but with the pointer: 


*ptr_to_a = 6; 


We’re using the asterisk differently here. When 
declaring a variable, putting an * before its name 
indicates the variable is a pointer. But once the pointer 
exists, putting an * in front of its name means ‘the 
variable pointed to by this pointer’; this is known as 
dereferencing the pointer. So this line tells the compiler 
to set the variable pointed to by the pointer ptr_to_a to 
6. We know that the variable pointed to by ptr_to_a is 
a, So this line is just another way of setting a to 6; and if 
we print the value of a, we find it has changed to 6. 

The next lines should help you to understand 
the relationship between pointers, variables, 
and addresses: 


printf ("The value of ptr_to_a is %d\n", 
ptr_to_a); 


In this line, we’re printing the value of ptr_to_a; 
not the value it’s pointing at, but the value of the 
pointer itself. This prints a very large number, as it’s 
the address in memory where a can be found. 
printf ("It stores the value %d\n", *ptr_to_a); 

In this line, we’re printing the value pointed to by 


ptr_to_a; note the asterisk before the name. This 
prints the value of a. 


printf ("The address of a is %d\n", &a); 
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Finally, in this line, we’re printing the address of a 
itself, the same as the value of ptr_to_a we printed above. 
The crucial thing to remember when working with 

pointers is this: you can’t just declare a pointer, 

you need to also declare and associate the variable 
you want it to point to. When a pointer is created, 

it points at arandom location in memory; if you try 
and write something to it, you can cause all sorts of 
errors. Always make sure your pointers are pointing 
at something before doing anything with them. 


Void pointers and casting 

You can also define a pointer without saying what 

type of variable it’s pointing to; this is a void pointer, 
written as void *. A pointer is just an address in 
memory, so we don’t necessarily need to know what’s 
at that memory. To use a void pointer, you need to cast 
it: tell the compiler what sort of pointer to treat it as... 


#include <stdio.h> 
void main (void) 


{ 


int intval 255958283; 

void *vptr = &intval; 

printf ("The value at vptr as an int 
is %d\n", *((int *) vptr)); 

printf ("The value at vptr as a char 
is %d\n", *((char *) vptr)); 


We initialise the void pointer vptr to point to an 
integer variable called intval. 

In the first printf statement, we insert (int *) 
in front of vptr before we dereference it using *. This 
casts vptr to an integer pointer, and so the value of 
intval is printed as an integer. 

In the second printf statement, we insert (char *) 
in front of vptr before we dereference it. This casts vptr 
to achar pointer, and so what is printed is the value 
of the char which makes up the first byte of intval. 


What do you use pointers for? 

Why bother with pointers°® We can already access 

a variable with its name. There are several ways in 
which pointers are useful, which we will explore in 
the future. But a few of the important ones are: 


FUNCTION CALLS — in the next instalment we will look at 
how to split up C code into functions; pointers are very 
useful for allowing a function to return multiple values. 
STRING HANDLING — in C, a String is a continuous block of 
memory with a letter stored in each byte; pointers make 
it possible to perform efficient operations on strings. 
ARRAYS — C allows array variables — lists of values of 
the same type — which, like strings, are stored in a 
continuous block of memory; pointers make accessing 
arrays easier and more efficient. 
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INCREMENTING 
POINTERS 


You can use 
++ and --on 
pointers, but 
you need to 

be careful. 
(*a)++ 
increments 
the value 
pointed to by 
a, but *(a++) 
increments the 
pointer itself 
rather than the 
value it points 
at; this will 
move a to point 
at the memory 
address 
immediately 
after a. 


ALWAYS 
HAVE 
SOMETHING 
TO POINT TO! 


It's worth 
stressing this 
again: a pointer 
is not a piece 
of memory, it’s 
just an address 
of memory. If 
you want to do 
anything with 

a pointer, you 
need to declare 
something for 
it to point to 

as well as the 
pointer itself. 


MEMORY 


Pointers are 
one of the 
ways C allows 
(or in some 
cases forces) 
you to think 
about what 
the actual 
hardware 

of your 
computer is 
doing; a good 
understanding 
of pointers 
gives you 

a good 
understanding 
of how the 
compiler 
handles 
memory. 
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RACHEL-CHLOE GREGORY 


Rachel-Chloe is an engineering grad 


Emojis representing who's around == who now gets to make Internet of 
Trigger actions like an SMS based are sent to your dashboard on - ") Things projects for a living at Initial 
on when someone comes or goes Initial State's website o State, a data visualisation service. 


initialstate.com 


All you need 


fi ((6)) Biwho's at the office? feedback support rache!@initialstate.com 


# Edit Tiles 04:22:25.321 PM 04:23:26 PM 


V4 


is an internet 
connection 


Se _ - ® 
2 2 ss 6 oe 


seeeaeees 
Seeneees) 
SSe5e8eees 
seeeeaces 
Seeeeces! 
Seeeeneaal 


Sesaaeaeaaa 
BSeeueceaee 


KNOW WHOS AT HOME 


Set up a sensor-free presence detector to let you know 
when someone’s close enough to connect to the WiFi 


ooking for an easy and useful project for Update your Pi and install arp-scan, an Address 
> USB WiFi that Pi you just have lying around? Find out Resolution Protocol packet scanner that shows every 
adapter who’s home and who’s not, or when your active IPv4 device on your local internet: 
cca favourite coworkers are at the office, with just a Pi 
and an internet connection! This WiFi-based presence sudo apt-get update 
detector will take hardly any time at all, and you’ll sudo apt-get install arp-scan 
suddenly have a base for triggering all sorts of things 
when someone is detected, like that theme music Once arp-scan is installed, you can test it with: 


you've always wanted. 
sudo arp-scan -l 


Presence detection 


The way that we’re going to detect ‘presence’ is by You should see a list of devices and corresponding 
scanning the WiFi network for certain devices’ MAC MAC addresses run down the screen; it could take a 
addresses, the unique identifiers that your phone or little while to load if on a large network. 

laptop gives when connecting to a network. Detecting A quick Google search will tell you how to find 
devices can also be done via Bluetooth; however, not your particular phone/laptop MAC address, usually a 
everyone will always have their phone’s Bluetooth series of 12 letters and numbers separated by colons. 
turned on, so WiFi should be a bit more reliable. You can check to see if your device appears on the 
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arp-scan list of devices if the following command 
returns an address: 


sudo arp-scan -1 | grep DEVICEMACADDRESS 


If your phone was found, the command will output 
its address. If it wasn’t found, make sure that it’s 
connected to the same WiFi network as the Pi (or vice 
versa). You may also need to wake up your device, as 
many devices disappear when they ‘sleep’. 


Initial State 


We’re going to use Initial State to create a real-time 
dashboard showing who’s at the office and who isn’t. 

Go to app. initialstate.com/#/register/ and create a 
new account. Install the Initial State Python module 
on your Pi: 


\curl -sSL https://get.initialstate.com/ 
python -o - | sudo bash 


You will be prompted to create an example script; 
this isn’t essential to installing the module, but can 
help test your ability to stream to Initial State. 


The code 


You can clone the GitHub repo to get the 
presence.py Script: 


git clone https://github.com/initialstate/ 
pi-sensor-free-presence-detector.git 


We use threading to create separate pieces of code 
that run at the same time as each other. This allows us 
to look for more than one device on the network more 
reliably. The subprocess module lets us call arp-scan 
within our Python script. 

To customise the script, change the arrays of names 
and addresses to match your own. In this use case, we’re 
tracking who’s at the office, so we have an array with our 


This small setup would fit perfectly in a 3D-printed enclosure 


=< iF 


{ 


ThePiHut 
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SENSOR-FREE PRESENCE DETECTOR 


Tutorial 
qanguage 


>PYTHON 3 


names. The address array contains the corresponding 
MAC addresses for our phones. If you want to add more 
devices, simply add more values to both arrays. 

You’ ll also need to replace YOUR_ACCESS_KEY 
with your Initial State access key, which can be found 
on your Initial State Account page. 

Run the script with: 


DOWNLOAD: 
magpi.cc/2dDyuoV 


TRIGGERING 
AN ACTION 


sudo python presence.py 


Easily set up 
SMS or email 


Watch what prints to the terminal to make sure 
your devices are being detected, and that streaming 
is working. Head over to Initial State to check out 
your dashboard! 


alerts within 
Initial State or 
customise the 
code to make 
the Pi trigger 
something. 


Run from boot 

To make this truly useful and reliable, we need to 
handle any network issues. We found the easiest 
solution to be rebooting the Pi whenever the network 
connection drops. First, we need to create a Script to 
check the WiFi and then trigger shutdown: 


sudo nano /usr/local/bin/checkwifi. sh 


Place the following inside the file, making sure to 
replace the IP address with the IP address of your router: 


ping -c4 IP_ADDRESS > /dev/null 


if [ $? != 0 ] 
then 

sudo /sbin/shutdown -r now 
Fi 


The ping checks for a connection. If it returns 
with a non-zero exit code, the script sends the 
shutdown command. 

Save and exit the script. Now make sure its 
permissions are in order: 


sudo chmod 775 /usr/local/bin/checkwifi. sh 


Running a script from boot on the Pi is pretty 
straightforward with the service crontab: 


sudo crontab -e 


Pick your favourite text editor (such as nano) and at 
the bottom of the file, under all of the comments, add 
@reboot nohup sudo /usr/bin/python /home/ 
pi/presence.py &torun the presence.py script. If 
you named your script something else or put itina 
different directory, replace /home/pi/presence. py 
with the correct path. Then, under that, add */5 
* * * * /usr/bin/sudo -H /usr/local/bin/ 
checkwifi.sh >> /dev/null 2>&1 torunthe 
checkwifi.sh script. Exit crontab and reboot the Pi to 
run your new presence detector! 


EMOUJIS 


You can 
change 
the emoji 
icon in your 


dashboard 

to represent 
your personal 
use case, such 
as a house or 
hospital. 
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Youll 
Need 


> 2x HC-SR501 
PIR sensors or 
equivalent 


> 2x Common 
anode red / 
green LEDs - 


rete Play the classic statues game with the Raspberry Pi as the arbiter, 
fees §Wich also supplies the music 


> 2x 1.2nF surface- 
Ale Ela ihes estes ere ) he coming festive season often involves 

> 9-way ribbon playing games, and musical statues is one of 
oetad the classic favourites. For anyone who is not 

> Stripboard familiar with the game, it involves players dancing 

> Angle aluminium around to music. When the music stops, they must 

| = adopt a pose and hold it like a statue; the player first 

to move is out. In this version there are two players 

who face off against each other, and PIR (passive 

infrared) sensors detect who moves first. For some 


unknown reason, all participants seem to also pulla 
funny face when freezing. 


> MDF board 


> Assorted nuts 
and bolts 


The circuit 
The sensor we chose to use is the very low-cost 
HC-SR501 PIR, although most others would probably 
work. Unfortunately, it does not have an ideal operating 
characteristic for this application, but luckily this is 
easy to fix. In the retrigger mode, the output goes high 
for a minimum amount of time set by an adjustment 
pot. Then, if more movement is detected during the 
high output time, the timer is triggered again and the 
output doesn’t go low until no movement is detected 
for the minimum high time. When the output goes 
low, it stays low for a fixed time and then the sensor is 
activated again, ready to respond to movement. While 
this behaviour is fine, what is not suitable for our game 
arbiter is the actual duration of these times. Even with 
the adjustment pot set on the minimum value, the delay 
obtained on the pot is approximately 5 seconds. The 
fixed time to activate the sensor again is about 3 seconds 
and has no adjustment control. Therefore we require 
a bit of hacking to shorten these times. This is done 
simply by replacing two capacitors with smaller ones. 
These are surface-mount ones; that might put some 
people off, but it is simple if you have a pair of tweezers 
Red/green LEDs indicate and a fine-tipped soldering iron. 
pease Ades rae Fe ae left Wiring up these sensors is easy: just 5V and ground 
ght or le 

and the output is an open drain configuration, so 

simply wire it up to any GPIO pin and enable the 
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3V3 3V3 


Left LED Right LED 


150R ; : 150R 


GPIO4 GPIO17 


150R 150R 
3V3 oV 


GPIO27 GPIO22 


STATUES PI 


oV 


Left PIR 
HC-SR501 


Right PIR 
HC-SR501 


3V3 oV GPI018 GPIO23 


Raspberry Pi GPIO 


pull-up resistors. The indicator for each side is a red/ 
ereen LED of the common anode type. This means 

to turn it on, the GPIO pin is set to zero. Usinga 
150Q, resistor gives 10mA through each LED, which 
is quite bright enough. The full schematic is shown 
in Fig 1; see the step-by-step section for details of 
construction. Note that when powering up, it takes 
about a minute before the sensors respond, as they 
have to auto-calibrate. 


The game 


The game is split into four phases: 


1) SETUP — the sensors wait until there has been no 
movement on either side for a time given by the 
startDelay variable. When this occurs, the music 
Starts and the game progresses to the next phase. 


2) RUNNING — the movement sensors are monitored, 
the music is looped if the file has ended, and the LEDs 
show movement, until the time in the playDuration 
variable is exceeded and the music stops. Then the 
game progresses to the next phase. 


3) WINNER — when the time for the players to freeze, 
given in the stopDelay variable, has expired, the 
sensors are monitored to see who moves first. The 
winner is then displayed and the winner’s LED is lit 
up yellow. After a small delay, the game progresses 
to the last phase. 


4) RESTART — the game will halt until the computer 


operator presses the space bar. The game now goes 
back to the first phase. 
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Fig 1 The circuit diagrams for the project 


BUILDING THE STATUES 
CONTROLLER 


>STEP-O1 

Modify the sensors 

Locate capacitor CY1, under the pot delay RT1; and CY2, just above the 
ground pin. Remove them by quickly alternating your soldering iron 
from one end to the other until both ends melt and you can flick it off or 
grab it with tweezers. Clean the pads with some solder braid to remove 
all the solder; work quickly so you do not lift the pads. Then replace 
them with a 1nF to 1.5nF capacitor-— we used a 1.2nF. Cut a 30mm length 


of 18mm by 6mm strip pine for the mounting stick and paint it if you like. 
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Anode 
LED pin out 
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>STEP-02 
Make the PIR mounts 


Make four brackets 11mm wide 


statues.py 


from 2mm thick asymmetric Q@1. #!/usr/bin/env python 
aluminium channel 12mm by Q2. # Statues 
24mm by 24mm. Drill 2mm holes 03. 

Q4. import time, pygame 


in the short side to fix the PIR 
sensor to the bracket with an M2 
nut and bolt. Cut the long side 

of two brackets down to 18mm 

so they do not overlap when 
attached to the sensor. Drilla 
3mm hole in each long side so you 
can fix it to the stick with M3 nuts 
and bolts. Make sure the brackets 
do not foul any of the PCB tracks; 
assembly can be fiddly anda 
miniature spanner helps. 


>STEP-03 


Add the electronics 

The few electronic parts fit ona 
piece of 6 by 24 hole stripboard, 

the copper strips running along the 
short side. Drill three 1mm holes 
through the stick to allow the LED to 
be mounted on the other side. Wire 
the power and signal connectors of 


OS" 
06. 
07. 
08. 
Oo: 
IhZ)F 
a I 


Ze 
er 


14. 
dee 
iG: 


ye. 
18. 
19: 
20. 
PZ 
22 


23. 


import os, sys, random 
import wiringpi2 as io 


pygame.init() # initialise pygame 
os.environ[ 'SDL_VIDEO WINDOW _POS'] = 
pygame.display.set_caption( Statues") 
screen = pygame.display.set_ 
mode([300,100],, 32) 
pygame.mixer.quit() 

pygame .mixer.init(frequency=22050, size=-16, 
channels=2, buffer=512) 


"center' 


pygame.event.set_allowed(None) 
pygame.event.set_allowed([pygame. 

KEYDOWN, pygame.QUIT ] ) 

moveSound = pygame.mixer.Sound("sounds/s®@.ogg") 
pygame.mixer.music.load("“sounds/tune.wav") 
pygame.mixer.music.set_volume(1.0) 
pygame.mixer.music.play() 
pygame.mixer.music.pause() 

imageNames = ["ready","still","dance","freeze", 
"leftWin", "rightWin", "play" ] 

messages = [ pygame.image. 
load("images/"+imageNames[m]+". png") 


the PIR sensors through a three-pin 2a. for m in range(@,7) ] 
header socket to the board. Then 29's 
wire it all back to the Raspberry Pi 26. setup = @ 3 running =1; Winher = 2; Pstart — 3 


through a length of 9-way ribbon 
cable. Attach the ribbon cable to the 
stick with double-sided sticky foam 
pads, and make a 30mm bracket 
from 25mm by 15mm asymmetric 


» ‘ 


éy aluminium angle and fix it to an MDF 


here at the Bakery — it might be a bit techno for some. 


27. 
28, 
29): 
a0. 


# state machine constants 

status = rstart # state machine status 
stillTime = 0.0 

startDelay = 2.0 # period to hold before game starts 
stopDelay = 3.0 # period to wait after music 

# stops before looking at sensors 


ASS 31. playDuration = 4.0 # time the music plays 
Ma A ti board about 100mm by 200mm. 32. restart = False 
») ON tS 
35). 
34. def main(): 
The softwa re B5G global leftMovement,rightMovement, status 
Th oo, ™ 36.  initGPIO() 
e statues. py program is written as a state machine 37. print"Statues game” 
following the game phases. The stages of the game 38. print" Esc to quit" 
are displayed in a small window and simply display 39. leftMovement = False 
an image consisting of the words/instructions for 48. rightMovement = False 
the current phase of the game. It uses the Pygame ee ee 
f ican sae k A? checkForEvent( ) 
ramework and t € streaming music unction to make 43. ie Guevae == oot: 
sure that the music continues at the same point for the AA. nine 
next round when the game resumes. AS. if status == running : 
46. gameRun() 
Taking it further ai pe ore eh 
48. gameWinner() 
¢ 
We recommend the game is played as a ‘best of three 49. ee ee eee 
and you are out’ mode, but there is no software to 5Q. gameRstart() 
enforce that, so you might like to add some, or even owl ae 
keep a score of the rounds won by each player. It is D2. settingUp(): . 
best played at one end of a room, but you might have ce ANID SI LU MUS) SAG Nets ( MEN Telus 
f nf ees 54. checkSensors() 
to put some Sort of a screen in front 0 t e sensors 55. showLEDs() 
to stop any movement from the audience interfering Bee if stillTime == @: 
with them. You can replace the tune played with your ye stillTime = time.time() 
own; the tune in the GitHub repository is one we wrote 58. elif time.time() - stillTime > startDelay : 
59). status = running 
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60. playTime = time.time() AW pygame.draw.rect(screen, ( 
61. pygame.mixer.music.unpause() b,b,b), (0,0, 300,100) ,@) 
62. #"play music - game running" 128. screen.blit(messages[m],(@,®)) >PYTHON 
63. displayMessage(2,128) 1279. pygame.display.update() 
64. if leftMovement or rightMovement: 130. DOWNLOAD: 
65. stillTime = @ 131. def checkSensors(): magpi.cc/1NqJjmV 
# reset the still time before the music 132: global 
66. moveSound.play() leftMovement, rightMovement PROJECT 
67. displayMessage(1, random. randint (40, 22) ) 133: if io.digitalRead(pirPins[@]) VIDEOS 
68. == 1 and not(leftMovement) : 
69. def gameRun(): 134. leftMovement = True ChecicoutMilce's 
70. global leftMovement,rightMovement, status, playTime 135. elif io.digitalRead( Bakery videos at: 
(ale checkSensors() pirPins[@]) == @ and leftMovement: magpi.cc/41NqJnTz 
72s, ShowLEDs ( ) 136. leftMovement = False 
73. if time.time()-playTime > playDuration : 137. if io.digitalRead( 
FWA #"music stops" pirPins[1]) == 1 and not(rightMovement) : 
73x displayMessage(3,128) 138. rightMovement = True 
7G. pygame.mixer.music.pause() 139), elif io.digitalRead(pirPins[1]) == @ and rightMovement: 
V7. status = winner 140. rightMovement = False 
78. playTime = time.time() 141. 
79. else : 142. def showLEDs(): 
80. if not pygame.mixer.music.get_busy() : 143. if leftMovement : 
# check end of music file 144. io.digitalwrite(ledPins[@],@) # turn Red on 
oe pygame.mixer.music.rewind() 145. io.digitalWrite(ledPins[1],1) # turn Green off 
82): pygame.mixer.music.play() 146. else : 
83. 147. io.digitalwrite(ledPins[@],1) # turn Red off 
84. def gameWinner(): 148. io.digitalWrite(ledPins[1],@) # turn Green on 
85. global leftMovement,rightMovement, status 79. if rightMovement : 
86. if time.time() - playTime > stopDelay : 150. io.digitalWrite(ledPins[2],@) # turn Red on 
S7 checkSensors() 151, io.digitalwWrite(ledPins[3],1) # turn Green off 
88. ShowLEDs () 152:. else : 
89. if leftMovement or rightMovement : 153. io.digitalwrite(ledPins[2],1) # turn Red off 
90. moveSound.play() boys io.digitalWrite(ledPins[3],®) # turn Green on 
oie if leftMovement : 15 Die 
2. print"right player wins" 156. def initGPIO(): 
Sele winLED(1) dhe vee global ledPins,pirPins 
94. displayMessage(5,128) 158 ledPins = [ 4,17,27,22] # left R, left G, right R, right G 
oan else: 159. pirPins = [18,23] # left / right 
96; print"left player wins" 160. ERY =: 
OF. winLED(@) 161. io.wiringPiSetupGpio() 
98. displayMessage(4, 128) 162. except : 
oo. Status = rstart 163. print"start IDLE with ‘gksudo idle' from command line" 
100. time.sleep(3.5) 164. os. _exit(1) 
101. 165. for pin in range (0,4): 
102. def gameRstart(): 166. io.pinMode(ledPins[pin],1) # led pin to output 
103. global restart, status, stillTime, playDuration 167. io.digitalWrite(ledPins[pin],1) # turn off 
104. if restart : 168. io.pinMode(pirPins[@],8) # input left PIR sensor 
105. restart = False 169. io.pinMode(pirPins[1],@) # input right PIR sensor 
106. status = setup 170. io.pullUpDnControl(pirPins[@],2) # input enable pull up 
107. checkSensors() a Ie io.pullUpDnControl(pirPins[1],2) # input enable pull up 
108. ShowLEDs() 17 2. 
109. displayMessage(@, 128) 173. def terminate(): # close down the program 
110. print"ready" 174. print"closing down" 
dit. stillTime = 0.0 175: pygame.mixer.quit() 
De playDuration = random.randint(6,20)+6 7G. pygame.quit() # close pygame 
# time till next stop 177. os. exit(1) 
tis. else : 17S. 
114. displayMessage(6, 128) 179. def checkForEvent(): # see if we need to quit 
1153 180. global restart 
116. def winLED(player): 181. event = pygame.event.poll() 
cD li for i in range(@,4): # all LEDs off 182. if event.type == pygame.QUIT : 
1138, io.digitalWrite(ledPins[i],1) 183°. terminate() 
ahalis ys if player == 0: # winner's LEDs yellow 184. if event.type == pygame.KEYDOWN : 
126). io.digitalWrite(ledPins[@],0) 185. if event.key == pygame.K_ESCAPE : 
deal io.digitalWrite(ledPins[1],0) 186. terminate() 
22 else : 187. if event.key == pygame.K_SPACE : 
123% io.digitalWrite(ledPins[2],0) 188. restart = True 
124. io.digitalwrite(ledPins[3],0) 189. 
WAS 190. if _name_ == '_main_': 
126. def displayMessage(m,b): 191. main() 
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Tutorial 


WESLEY ARCHER 


Self-taught Raspberry Pi enthusiast, 
founder of Raspberry Coulis, and 
guide writer for Pi Supply and Cyntech. 
raspberrycoulis.co.uk 
@RaspberryCoulis 


SOFTWARE 


In the final part of our build, we’ll be getting the software 
working so you can start playing with your RaspCade! 


TREE Cee etna te, whilst ow that we have finally assembled our 
displaying our custom splash screen RaspCade, the last part of this build is to get the 
software up and running so that we can start 

playing retro video games to our heart’s content! Today, 
we’ ll be looking at how to install RetroPie, configuring 

| your controls, adding your games, and any other tweaks 
to get the most out of our RaspCade so that you can play 
your favourite games whenever you feel like it! 


Download RetroPie 
| RetroPie plays a Key part in our RaspCade, so head over 
to their website (magpi.cc/25UDXzh) and download 
the SD card image. Be sure to download the correct 
one for the Pi model that you’re using, although we do 
recommend using the Pi 3 for this to get the most out 
of your RaspCade. For those of you who are unfamiliar 
with RetroPie, it’s a fantastic piece of software that 
runs various video game emulators, but all within 
a beautiful user interface that closely matches 
today’s generation of consoles. It’s actively 
developed, and updates are pretty regular! 


Youll 
Need 


> Class 10 micro 


eA Se tee | | / Write your SD card 

recommended) . * Now you have your SD card image, you can write 
SP ECtrOLIC | | a this to your SD card using your preferred software. 

magpi.cc/ | ; Check out Raspberry Pi’s official documentation on 

eee , how to do this (magpi.cc/1V50j8E). We do recommend 
> USB flash | i , investing in a quality SD card here; a Class 10 card is 


drive (optional) 


essential, as it will provide fast read and write speeds. 
> Our custom | The card will also need a decent amount of storage 
splash screen This USB port makes ; 
epee adding new game Space if you want to store your ROMs on it; we would 
2dFLRQN ROMs a breeze! recommend at least 16GB of space for this, but up to 
32GB is supported. 
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Tutorial 


30 GAMES AVAILABLE 


ae MENU © SELECT » CHOOSE 


Af 

and then follow the on-screen prompts, pressing We highly 
Boot your RaspCade the relevant buttons when needed. You can skip Si cesar e cep 
Once your SD card has been prepared, it’s now time assigning a button by holding any button until the PCB as it takes the 
to pop this into your Pi and boot up your RaspCade! tutorial moves on. All being well, you should be able lester pani pea 
All being well, you should see the RetroPie logo to assign directions to your joystick, as well as the - a definite must! 
as your RaspCade boots. You can use our custom eight arcade buttons. 
RaspCade splash screen (magpi.cc/2dFLR9N) if you 
like and we’ll cover how to change this shortly. The CUSTOM 
first boot usually takes a little longer than normal, as Transferring your ROMs RASPCADE 
the file system will be expanded to fill your SD card, ROMs, short for Read-Only Memory, are the game SPLASH 
but you’1l know when it’s done when you see the files. These are basically a collection of the files SCREEN 
welcome screen. you’d find on a game cartridge if you took the 


data straight off them, and you’ll need them play 

certain games on your RaspCade. The quickest 
Setting up your controls way of transferring the ROMs to your RaspCade is 
Fortunately, RetroPie makes setting up your controlsa by following the USB guide on RetroPie’s website 
simple process; you’re asked to do this during the first (magpi.cc/2dmE14h), as this will automatically 


boot. You should now see the welcome screen asking transfer all the files to the correct place without any 
you to hold a button on your device to configure it. major user input. You can use the USB port on the 
Press and hold one of the buttons on your RaspCade front of the RaspCade to do this, too! 


Restart and play! ROMS 
Once you have added all your ROMs, you need to ON USB 
restart your RaspCade so that RetroPie can load INSTEAD 
them. You should notice that different gaming 
systems will appear after you have rebooted, 
mirroring those that you’ve added. Now you can 
simply pick your system, choose your favourite 
game, and start playing on your very own RaspCade! 
You may need to tweak a few more settings, such as 
the display and controls for different systems, but 
we recommend getting to know the RetroPie wiki 


2 : ; 
Whilst not in this guide for simplicity, putting NeoPixels pee (magpi.cc/2emU7fV) as there's a wealth of 
inside the buttons adds some pizazz to the RaspCade information there. 
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> Pi Cap and 
Electric Paint 
magpi.cc/ 
ze8kmGK 


> micro-USB cable 
> Pi power supply 
> Crocodile clips 


> Acrylic 


> Glue 
> Cardboard 


> Aluminium foil 


CROCODILE 
CLIPS 


PAUL TANNER, 
_ ROSS ATKIN 
& TINA ASPIALA 


Paul, Ross, and Tina are loT developers, 
engineers, and designers. They enjoy 
testing the limits of the latest tech with 
Bare Conductive. 

magpi.cc/2dDDdXP / @BareConductive 


Four of the Pi Cap's 12 
capacitive electrodes 
are being used as 
proximity sensors 


The game runs on a Pi Zero 
with a Pi Cap add-on and 
Ethernet cable 


Players move their hands 
between the Electric Paint 
sensors to control the 
paddles on screen 


PONG GAME 


Make a physical version of Pong! Use capacitive sensing and Electric Paint 
to make a fun and addictive two-player game to play with your friends 


apong breaks Pong out of the screen and 

into your hands. Map the Pong paddles to 

the position of your hands, using a Pi Cap 
and Raspberry Pi, to create a simple and addictive 
game. Capong is a physical reinterpretation of the 
original video game. Instead of mouse or arrow keys, 
it uses Sensors arranged on a laser-cut stand so 
that each player moves her hand between a pair of 
sensors. The game is based on SimplePong, available 
on openprocessing.org and released under Creative 
Commons. It was modified to use input from the Pi Cap 
sensors and converted to two-player operation. 


First steps 

First, we need to set up the Pi Cap. Run through the 
‘Setting up your Pi Cap on the Raspberry Pi Zero’ 
tutorial found at magpi.cc/2emLB1K, and don’t miss 
any steps. (You need to know the IP of the Pi to log 
into it.) Run through the Pi Cap intro to see the code 
examples, particularly the one that streams the sensor 
data via OSC to your laptop terminal window. Notice 
the DIFF data; that’s what we’ ll be using. 
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Once you’ve done this, download and install 
Processing if that’s not already on your laptop. Unzip 
and install the code mpri21_ pong in Processing’s 
sketch folder, usually /Documents/Processing. Open 
the sketch in Processing and start it running. To run 
the OSC demo standalone, go to your PiCapExamples 
folder on the Pi and cd to cpp/picap-datastream- 
osc-cpp. Use ./run to see the Pi Cap datastream. Find 
out the IP of your laptop then use ./run -host [IP 
address of laptop] to stream it to Processing. Pong 
should now be running. Click the laptop mouse to 
start a game; it finishes when a player misses the ball. 
Click the laptop mouse to start another game. 

If you want to build the acrylic stand, as seen in our 
version, you can download the Illustrator files online 
(here: magpi.cc/2enaB7V and here: magpi.cc/2enc6Tn) 
and follow the tutorial instructions, courtesy of 
@rossatkin. You will need a laser cutter to cut these out, 
or you can make it out of foam board. 

To assemble your stand, glue one of the I-shaped 
pieces of acrylic to the white rectangular piece with 
no holes in it. 
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=i 


pele 


To build the acrylic stand seen here, you 
can download the Illustrator files online 


Before you glue in the two red rectangular pieces, 
make sure to insert two of the crocodile clips inside 
the structure; there should be a slot for the cables 
to exit when you attach the sides. This will ensure 
the wires are concealed within your stand, but 

still accessible. 

Glue the two red rectangular pieces to the white 
structure. Using a small paintbrush, dab all the joints of 
the stand with the acrylic glue; this adhesive will melt 
the plastic pieces together. Careful with the red acrylic: 
it may melt and release some colour. You should still 
have one acrylic piece remaining: the white rectangle 
with two holes. Don’t glue this piece on yet. 

Stand your Capong upright, so the white piece with 
no holes is touching the tabletop. Make sure you have 
enough wire so that your crocodile clips protrude at 
the top; you need at least 7.5cm of croc clip visible, 
as Shown in the picture. 

Now, leave some length of the wire out the 
bottom of the stand, and cut and strip the wire. You 
should have about 1.5cm of copper wire protruding. 
You’re going to use this to attach the copper wire 
to the sensors. 

Cut out two cardboard squares and two rectangles. 
These will go on your stand so you can measure the 
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CAPONG - A PONG GAME 


RED 
ACRYLIC 


Careful when 


gluing the 
red acrylic — 
it may melt 
and release 
some colour. 


Left Be patient 


with the build and 


you'll get there 


Bottom left 
You may need 
to shorten 
your crocodile 
clips during 
construction 


STRAIN 
RELIEF 


Secure each 


cable on its 


sensor so 
they don't 
move (you can 
use double- 
sided tape). 
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Tutorial WALKTHROUGH 


: a a = ire = % ¥ " £ 7 2 


Oi IMpore OSers. = 
Q@2. import netP5.*; 


Q3. 
04. final int numElectrodes = 12; 
O5- 
06. boolean serialSelected = false; 
07. boolean oscSelected = false; 
08. boolean firstRead = true; 
09. boolean soloMode = false; 
IG: 


11. boolean gameStart = false; //true; 
12. 

13, 1 loan x = 150; 

14. float y = 150; 

15. float speedX = random(3, 5); 
16. float speedY = random(3, 5); 
17, ine Leftcolor = 128; 

18. int rightColor = 128; 

19. int diam; 

20. int rectSize = 150; 

21. float diamHit; 

22. int vposi = @; 

23. int vpos2 = @; 


24. 
25 
26. OScP5 oscP5; 
27: 
23. nt ||) Gikfs: 
Above top Paint size of the interior surfaces. If you’re using Electric 29. 
aaa Paint, you can paint directly onto these squares. 3Q@. int globalGraphPtr = @; 
and to cold- Once dry, apply some double-sided tape; you’re 31. int electrodeNumber = 0; 
ac going to glue the sensors face down against the 32. int serialNumber = 4; 
acrylic. But first, you must cold-solder the paint! 33. int lastMillis = 0; 
soctiec ia Using your Electric Paint tube, squeeze out 34. 
fourcrocodile a generous amount of paint onto the exposed 35. void setup() { 
ee copper. You should make sure the wire is held 36.  size(500, 50); 
correctelectrode in place so that it doesn’t move around; you can 37.  noStroke(); 
use double-sided tape. When you’re finished, 38. smooth(); 
you should have four sensors — two square, two S\e). 
rectangular — connected to each of the sides of the 40. // setup OSC receiver on port 3000 
Capong stand. 41. oscP5 = new OscP5(this, 3000); 
If you don’t have Electric Paint, you can 42. 
make your sensors using aluminium foil. Just 43. // other setup 
follow the same steps as above, but sandwich 44. diffs = new int[numElectrodes ]; 
the exposed wire between the aluminium foil 452} 
TROUBLE- and the cardboard. 46. | 
SHOOTING You can now firmly attach your sensors to the 47. void oscEvent(OscMessage oscMessage) { 
stand and get out your Pi Cap and Pi Zero. Take the 48. println("oscevent"); 
Make sure crocodile clips that are protruding from the top of 49. 
pea d the Capong stand and attach them to your Pi Cap’s 50. if (firstRead && oscMessage. 
the correct electrodes. Make sure you’re connecting to the Ble checkAddrPattern("/diff")) £{ 
crocodile clip correct electrodes, the ones you’ve programmed firstRead = false; 
pene ee mere for functionality. 52h 
combination. Now you can connect your Pi Zero, upload the 53. else { 


code, and get playing! 
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54. if (oscMessage.checkAddrPattern('"/diff")) { 15. diamHit = random(75,15@); 
55s // simulate mouse in original game 106. ellipse(x,y,diamHit >PROCESSING 
Slay updateArrayOSC(diffs, oscMessage. »diamHit) ; 
oye arguments()); 107. rectSize = rectSize-10; DOWNLOAD: 
vposi=diffs[10]-diffs[1]+100; // guesswork 108. rectSize = WEE] SME et (eae 

58. Vposd-—2.5. constrain(rectSize, 10,150); 
59. if (vposi > 450) vpos1=45@; // limits 109. } 
6Q. if (vpos1 < 80) vposi1=80; 110. 
61. vpos2=diffs[@]|-diffs[11]+100; // guesswork d bale // 1f ball hits wall, change direction of X 
2. vpos2*=2.0; (single-player only) 
63. if (vpos2 > 450) vpos2=450; // limits 1412. else if (false && x < 25) { 
64. if (vpos2 < 80) vpos2=80; dike SpeedX = speedX * -1.1; 
65. print(vpos1, vpos2); 114. xX = X + SpeedXx; 
66. lead ie TiS. leftColor = 0; 
67. } 116. } 
68. } slg 
69. } 113. else { 
70. (lakes leftColor = 128; 
71. void draw() { 120. rightColor = 128; 
72 background(255) ; AN } 
Ta 122. 
74. Fi11(200,0,0); 123%. // resets things if ball hits either wall - you lose 
75. diam = 20; 124. if (x > width ||| x < 6) 4 
76. ellipse(x, y, diam, diam); 125: gameStart = false; 
FL 126; //delay(50@0); // auto-restart 
78. #111(200,0,0); 27 //gameStart = true; 
79 rect(width-30, vposi-rectSize/2, 10, rectSize); 128. x = 150: 
80. rect(30, vpos2-rectSize/2, 10, rectSize); 129. Va— 156; 
81. 130. SpeedX = random(3, 5); 
82. if (gameStart) { eile speedY = random(3, 5); 
83. 1327. rectSize = 150; 
84. xX = X + SpeedXx; 3 3% } 
Soe y = y + speedy; 134. 
86. 135. // if ball hits up or down, change direction of Y 
Se // if ball hits movable bar, invert X 1262 if (yy > heient || y< 6) 4 

direction and apply effects 13H. SpeedY = speedY * -1; 
88. if ( x > width-30 && x < width-20 && y > 138. y = y + speedy; 

vposi-rectSize/2 && y < 139. } 
vposi+rectSize/2 ) { 140. } 

Bo: SspeedX = speedX * -1; 141. } 
90. xX = X + SpeedXx; 142. 
O17 palfe|qulGoylo)e = 14) 143. void mousePressed() { 
92. Fi11(200,0,0); 144. gameStart = !gameStart; 
937 diamHit = random(75,150); 145. } 
94. ellipse(x,y,diamHit, diamHit) ; 146; 
95. rectSize = rectSize-10; 147. void updateArrayOSC(int[] array, Object[] data) { 
96. rectSize = constrain(rectSize, 10,150); As eee (decay =e nul eledatan———iu lal) 
oT. } 149. return; 
98. 150. } 
ook // similar if ball hits the other movable bar 151. 

(2 players) Pee. for (int i = @; i < min(array.length, 
100. else if ( xX > 20 && x < 30 && y > vpos2- data.length); i++) { 

rectSize/2 && y < vpos2+rectSize/2 ) { 1532 array[i] = (int)data[i]; 
101. SpeedX = speedX * -1; 154. } 
OZ X = X + SpeedXx; Sey 
103. rightColor = 9; 156. 
104. £i11(200,0,0); 157. 
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USB TV tuner 


linuxtv.org/wiki 


USB remote 
control 
magpi.cc/ 
2dDLriE 


USB hard disk 
magpi.cc/ 
2dDLN8F 


Powered 
USB hub 
magpi.cc/ 
2dDLFGh 


OSMC 
osmc.tv 


MPEG2 codec 
magpi.cc/ 
2dDLToc 


We used a 3A powered 
USB hub to prevent 
brownouts when 
watching telly 


The Pi 3 provides 

enough juice to power 
the TV tuner directly; 
older Pis would struggle 


You could house the PiVR 
in an old set-top box, or 
build your own case 


A PI-POWERED PVR 


Make your own PVR to record and watch live TV, 


as well as stream video and audio 


he secular festival of Good Telly Season is just 
around the corner, so what better time to make 
a PVR that does everything? From recording 

TV shows to streaming favourite films from your NAS 
to playing tunes from your smartphone, a PiVR can do 
everything apart from virtual reality: the name’s a little 
misleading like that. 

Better still, your PiVR only uses USB devices and 
requires a few fairly basic terminal commands to get 
running. There’s nothing here to scare a Pi novice, and 
plenty to please the experts. 

The PiVR is based around a Pi 3, both for its 
processing power and the current it can feed to USB 
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devices. The TV tuner used in this project can be 
found here: magpi.cc/2dDMTS7. However, with this 
TV tuner taking up to 500mA, an old laptop hard disk 
sucking 1A and the Pi itself consuming up to 800mA, 
we worried about brownouts if we powered everything 
from the Pi. We therefore based our project around a 
3A powered USB hub: plenty of headroom. 


OSMC and the software 

We chose OSMC (osmc.tv) as the basis for the PiTV, 
as it incorporates the popular Kodi front-end (albeit 
in skinned form) with a full Raspbian back-end. 
Essentially, it’s easy to use and easy to modify and 
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add to. Better yet, it’s a cinch to install: download the 
installer and it'll set up your SD card automatically. 
You can even enter your WiFi details during the install 
so the Pi is ready to go once it’s booted. 

Update OSMC and its apps in the usual way, over 
SSH. The login credentials are osmc/osmc: change 
these as soon as possible via the passwd command. 


sudo apt-get update && sudo apt-get -y upgrade 


If your hard disk has also lived a former life, wipe 
and format it with fdisk and then reboot. 


fdisk /dev/sda 


Next, mount the hard disk and link it to a folder 
called recordings: 


sudo mkfs.ext4 /dev/sda -L storage 
sudo mkdir /mnt/recordings 

sudo mount /dev/sda /mnt/recordings 
sudo chown osmc:osmc /mnt/recordings 
sudo chmod 777 /mnt/recordings 


Now you can find your Pi’s serial number, which 
is needed to buy an MPEG-2 codec licence for your 
Pi (this licence will be tethered to your Pi). Without 
an MPEG-2 codec licence, the Pi will have to decode 
the TV signal in software rather than its bespoke 
hardware, which can lead to overheating and general 
performance issues. Follow the instructions at 
magpi.cc/2dDLToc and pay the £2.40. Your licence 
code should arrive within 72 hours; add the entire line 
of the received MPEG~-2 licence to your config file: 


sudo nano /boot/config.txt 


Getting your TV tuner up and running might require 
some detective work, but your first step is to find 
your tuner on magpi.cc/2dDNSsLv. If you’re lucky, 
your tuner won’t require specific firmware, otherwise 
you’ ll have to download it, typically from GitHub: see 
magpi.cc/2dDMI9h. However, our PCTV TripleStick 
(292e) required even newer firmware, which we found 
at magpi.cc/2dDMiQm: 


wget http://palosaari.fi/linux/v41-dvb/ 

firmware/Si2168/Si2168-B40/4.@.25/dvb-demod- 
S12168-b40-01. fw 

sudo mv dvb-demod-si2168-b40-01.fw /1lib/firmware 

sudo reboot 

dmesg 


The return from dmesg shouldn’t list any errors 
regarding firmware not downloading. If so, you can 
proceed to setting up Tvheadend, the server and 
client combination that handles all the live TV duties 
for the PiVR. 
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PIVR 


Tutorial 


ea Live TV 


9:18 PM 


OSMC itself is attractive and easy to use; it'll 
work with most USB remote controls, too 


Tvheadend on OSMC 


The easiest way to install the latest, correct version of 
Tvheadend is via OSMC’s front-end. First, you must 
navigate its awkward setup procedure; use onlya 
keyboard, as it’s too easy to get confused as to which 
level of menu or option you’re selecting with a mouse. 
Once negotiated, head to My OSMC and track across 
to Remotes to set up your remote. Then track back to 
the OSMC Store and install Tvheadend (it’s free, don’t 
worry), not forgetting to select Apply to actually start 
the installation. 

Once installed, you’ll need to switch to another 
computer to set up Tvheadend; point a browser to 
http://<pi-ip-address>:9981 and log in with 
osmc/osmc. Now follow this setup order to avoid 
getting into awful tangles with Tvheadend. First, 
head to Configuration > DVB Inputs > Networks. 
Click Add and then choose DVB-T as the Type; on the 
next screen give your ‘network’ a relevant name and 
select the correct Predefined Mux for your TV area (see 
digitaluk.co.uk if you’re not sure). If you’re on the 
edge of two masts’ coverage, add a network for both. 

Now go to the TV adapters tab and select your TV 
tuner; on the right-hand pane, tick the Enabled box 
and add any and all networks via the Networks field. 
Head to the Muxes tab and you should see many 
entries with a scan status of PEND; after a while, these 
will switch to Active, and hopefully then to OK. The 
last job in the Tvheadend webpage is to head to the 
Recording tab and change the recording location to 
your hard disk, in our case mnt/recordings. Click Save 
which is toward the top-left for this section. 

Now you can switch back to OSMC on your Pi. Head 
to Settings > Add-ons > My add ons > PVR clients > 
Tvheadend HTSP Client. Press Enter on your remote, 
then select Configure. Enter the Tvheadend login 
details (osmc/osmc) and then select Enable. Finally, 
head to Settings > TV > General and tick Enabled; you 
should see OSMC update a few things. Head back to 
the main OSMC menu and you’!] now see an option for 
Live TV. Open that, and you’ ll see an EPG and other 
such options. To watch a show, select it from the 
EPG and then press Back on your remote until you go 
‘beyond’ the main menu into full-screen live TV. 


NEATER 
BUILD 


Using a 314GB 
WD PiDrive 
(which only 
consumes 
0.55A) might 
allow you to 
drop the USB 
hub from 

the build. 


AUDIO 
ADD-ON 


OSMC 
supports 
AirPlay (from 
iTunes servers) 
While the Pi 3 
has Bluetooth 
—- upgrade the 
audio output 
and you've got 
a streaming 
jukebox. 


SCREEN OUT 


Add aVFD 
display for 
extra slickness, 


perhaps using 
a £10 ZeroSeg 
with the two 
buttons left off 
(magpi.cc/ 
2dOtGBg). 
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YOUR QUESTIONS ANSWERED 
NEEDA 
PROBLEM 


FREQUENTLY ggteita 
A S K 5 D OQ U E S T | O N S eminent 


to feature in a future issue. 


Your technical hardware and software problems solved... 4A 


sensors 

The Sense HAT is one of the most famous HATs; as 
well as adding a big LED matrix, it has extra sensors. 
This allows the Raspberry Pi to use humidity, 
temperature, and other measurements in programs. 
More inputs 


Some HATs can add extra buttons or input devices to 
the Raspberry Pi. The Skywriter HAT allows for motion 
controls, while the Piano HAT has capacitive piano 
keys you can use to create a symphony. 


Add-on 

A HAT is a type of add-on for the Raspberry Pi Extra ports 

that connects to the GPIO pins and gives it further Not quite as common are HATs that add extra 
functionality. There’s a specific definition that takes connectivity to the Pi. This can be alternate wireless 
into account size and other factors, but that’s the or wired internet connections, extra USB ports, or 
major part you need to know. even motor controllers to plug robot parts into the 


Raspberry Pi easily. 
Hardware Attached on Top 


HAT is an acronym (or possibly a backronym) of 
Hardware Attached on Top, as the hardware add-on is 
attached on top of the Raspberry Pi. Smaller HATs are 


sometimes called pHATs and are usually designed with Official HATs 


the Pi Zero in mind. The Sense HAT is currently the only HAT officially 
made by Raspberry Pi; you can get it from a few 
Other add-ons places such as Pimoroni, Elementi4, and other 
RelowThe Sense ere are other add-ons for the Raspberry Pi that official suppliers. Check out the page for it on 
HAT is the official aren’t called HATs; usually, they don’t meet the ‘HAT’ __ the Raspberry Pi website for more information: 
Raspberry PIHAT, —ecification mentioned earlier, but they’re no less magpi.cc/1TGGUt5 


and it's used on the _ 
Astro Pimission capable of giving extra functionality to the Raspberry Pi. 


Unofficial HATs 

These can be made by anyone and you’|I find them 
either on general Raspberry Pi online stores for the 
more generic ones, or on specialist sites for the more 
niche varieties. Just because they’re not made by Pi, 
though, doesn’t make them any less of a HAT. 


Make your own HAT 

If there’s a specific function you want to add to your 
Raspberry Pi, why not create your own special HAT? 
We did a tutorial on this in issue 42 of The MagPi 
(which you can find here: magpi.cc/Issue- 42), 

So give it a look. 
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What is the Camera Module? Camera Module is capable of taking photos up to 5 megapixels 


The Camera Module is a small PCB that connects to the and can record video at resolutions up to 1080p30. 
CSI-2 camera port on the Raspberry Pi using a short ribbon 
cable. It provides connectivity for a camera capable of Which picture formats are supported? 
capturing still images or video recordings. The camera The Camera Module supports raw capturing (Bayer data direct from 
connects to the Image System Pipeline (ISP) in the the sensor) or encoding as JPEG, PNG, GIF, BMP, uncompressed 
Raspberry Pi's SoC, where the incoming camera data is YUV, and uncompressed RGB photos. It can record video as H.264, 
processed and eventually converted to an image or video baseline, main, and high-profile formats. 
on the SD card (or other storage). You can read more about 
the Camera Module here: magpi.cc/28]jlsz. How do! use the camera? 

There are three command-line applications provided for stills, 
What model of camera does the Camera Module use? video, and stills output uncompressed. These applications provide 
The Camera Module V2 is a Sony IMX219, while the the typical features you might find on a compact camera, such as 
original Camera Module is an Omnivision 5647. They are set image size, compression quality, exposure mode, and ISO. See 
comparable to cameras used in mobile phones. the documentation for more details: magpi.cc/2egdAQA. 
What resolutions are supported? Can | extend the ribbon cable? 
The Camera Module V2 is capable of taking photos up Yes. We have reports of people using cables up to 4 metres long 
to 8 megapixels (8MP). It supports 1080p30, 720p60 and and still receiving acceptable images, though your experience 
VGAQ0 video modes, as well as still capture. The original may differ. 


Having trouble with The MagPi on the App Store or Google Play? MagPi ay 
Here are your most common questions answered: 50 ; 


How do | find The MagPi on Google Play or the App Store? GREATEST 
All you have to do is go to the search bar and type ‘The MagPi' Ee 
or ‘Raspberry Pi' to find us. 


I've subscribed to the digital edition and I can't sign Magri 


in to restore my purchases. Please help! SINIPLE 
Since your The MagPi purchases are linked to your Google or ae 
Apple accounts, there's no need to sign in at all. If you'd like to 

re-download your purchases on your current device, or make your 

purchases available on other devices, all you need to do is press 

‘Subscribe’ on the home screen, then ‘Restore Purchases’ on the 


next screen. 
GET IT ON 


>» Google Play 


How can | search the digital magazine for keywords? 
Finding direct references is really easy with The MagPi app: all you 
have to do is tap the screen to get the app’s GUI to show, and then 4 Available on the 


press the small magnifying glass icon in the top-right corner of the & App Sto re 
screen. Just type in your search term to find the relevant results. 
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Can you survive a walk in the 
woods and avoid all the nasty 
skeletons in this Scratch game? 


72 


Create a nasty surprise for 
anyone with this motion- 
activated screaming Pi. 


14 


Don’t waste candles: create a 
spooky, electric-powered 
jack-o’-lantern instead. 


November 2016 
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. ou should always be careful when walking 

| Y through the woods around Halloween; what if 
qi) a scary skeleton has a bone to pick with you? 
| In this tutorial we’re making a simple game in Scratch, 

‘ where you have to dodge the skeletons by pressing 

the left or right arrow on your keyboard in time. We’re 
making this in Scratch 2.0 in the new Raspbian with 
PIXEL Chromium browser; refer to the tutorial starting 
on page 46 for how to get it ready. 


walt until 


iene | 


set skeleton_location 


tog 


set skeleton_trigger to 9 | 


when space key pressed 


forever 


wait 0.5 | secs 


when nghterrow key pressed 


wait GED secs 


when spsce key pressed 


"skate biser = Ol 


AY Pre to ; 
‘andom € » to 13 J 


forever 


and skeleton location = 9 | 


set skeleton_tngger to pick random 


' 
veait 0. | secs 


ROB ZWETSLOOT 


Tinkerer, sometime maker, 
other-times cosplayer, and 
all-the-time features editor 
of The MagPi. 

magpi.cc / @TheMagP1 


SKELETON 


ri Create a spooky Scratch game and dodge those nasty skellies 


>STEP-O1 

Get some sprites 

We've already pre-prepared some sprites that you can 
use for this artful game of bone avoidance, which you 
can find here: magpi.cc/SkeleDodger. 

This includes an animated skeleton sprite, a 
pointer to warn you which direction a skeleton will 
come from, and a forest background. These were all 
obtained from OpenGameArt.org, an amazing place to 
get free graphics and sounds for your games. 

Go to scratch.mit.edu, start a new project, and click 
on ‘Upload backdrop from file’ to upload the forest 
background. We also then moved the cat so it looked 
like it was walking along the ground. 


>STEP-02 

Different costumes 

Load the skele1 sprite into Scratch by clicking on 
‘Upload sprite from file’ in the Sprites box. Place him 
on the left side of the screen for now. Click on the 
Costumes tab and click on the ‘Upload costume from 
file’ icon to upload the rest of the skeleton sprites. 
Once you’ve done that, click ‘Paint new costume’ 

to add one more sprite to the skeleton. Don’t make 
anything; just save it and name it skeleo. This allows 
us to have the skeleton disappear! Now, upload the 
pointer sprite in the same way, and create a blank 
costume for it so we can have it blink. 


>STEP-03 

Cat code 

See Fig-01 for how we’re coding the cat. When the 
green flag is pressed, the game is reset and the cat 
asks you to press the space bar to play. Pressing 
SPACE stops the cat’s message, then starts a looping 
walking cycle using its second costume. SPACE also 


ft &«© ££ &£ + & © es es 2 lL ee | ae ee 
sa 


Sail. 


Brit bb Cee vials ee 


6S ese Se Seesece 


! rot. skeleton_location bo 


I | I 
® Aspooky forest ® The cat is you, walking @ The skeletons are out to get 


V eek” skeinton_trgger 
background for our through the forest, not you! You'll get a warning 
very spooky game a care in the world where they're coming from 


>STEP-04 


5 et 


magpi.cc/SkeleDodger 


>STEP-05 >STEP-06 


| 
| Scratch 2.0 
| 
| 
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CREATE A 


Wilhelm Scream > ST E P a 01 
audio file - 

magpi.cc/ 

2diLoex 


HC-SR501 PIR 
sensor 
magpi.cc/ 
2diJivg 


Mini portable 
speaker 
magpi.cc/ 
2diQyHq 


Breadboard and 
jumper wires 


Connect the PIR 
sensor's OUT cable 
to GPIO pin 4. This pin 
is used in Python to 
detect motion and 
activate the scream 


The PIR sensor has 
three connections: 
live, ground, anda 
switch to connect to 
send a signal to the 
Raspberry Pi when it 
detects movement 


¥eeeeseeseeteeeseeseses 
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scream.py 


gpiozero MotionSensor 
time 
pygame 
pygame.mixer.init() 
pygame.mixer.music.load( ) 


pir = MotionSensor (4) 


pir.wait_for_no_motion() 


True: y 
( ) ; 
pir.wait_for_motion() 


( ) 


pygame.mixer.music.play() 
time.sleep(3) 


>STEP-02 


Witha 
a = portable charger 
>STEP 03 >STEP 05 it's possible 

to embed the 
Raspberry Pi inside 
a pumpkin. Just 
make sure the 
PIR sensor can 
view the outside. 
(image: Daryl 
Mitchel, Flickr) 


ass STEP-06 
> i 


Python 
magpi.cc/2dA5G1K 
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ELEC TRIC-POWERED 


>STEP-01 


LED (orange - 
or red works) 


Resistor 
(400Q) 


Wires and such 
(jumpers will do) 


Carved pumpkin 
(scary) 


You could go fora Poke the LED through 
classic, scary pumpkin the back; you probably 
like here but you don't want the whole 
could also make a Pi in there 

special pattern 


It's avery simple circuit to build; 
you can test it on breadboard 
and then make the LED cable 
from the Pi 
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>STEP-02 


>STEP-03 


>STEP-04 


>STEP-05 
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candle.py 


#!/usr/bin/env python 
RPi.GPIO GPIO 


time 
random randrange 


led pin = 18 


GPIO.setmode(GPIO.BCM) 
GPIO.setup(led pin, GPIO.OUT) 


led_pwm = GPIO.PWM(led pin, 200) 
led_pwm.start(100) 
def ( ye 
led_pwm 
led_pwm.ChangeDutyCycle(change_brightness) 
def Q): 
brightness(randrange(@, 100)) 


time.sleep(randrange(i, 10) * 0.@1) 


True: 
flicker() 


>STEP-06 


Python 
magpi.cc/2dzF94P 
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Waker 
days 


Use your 


Raspberry 
Pj to take 
control of 
this string 


puppet 


Simon Monk 


PUPPET KIT FOR RASPBERRY PI 


PUPPET KIT FOR 
RASPBERRY PI 


Your Raspberry Pi pulls all the strings with this innovative puppet kit project 


MAPLIN 
ROBOTIC 
ARM 


Maplin’s robotic 


arm is amuch 
more complex 


build with more 


functionality. 
It can be 


controlled from 


a Raspberry Pi 


with Fuze BASIC. 


£50 / S61 
magpi.cc/2dLweuN 
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he Puppet Kit by esteemed 
maker Simon Monk 
caught the attention 

of everybody at The MagPi. This 
quirky project has you detaching 
the strings from a traditional 
marionette and hooking them up 
to servo motors. These are then 
used with Python code to control 
the doll. 

“How cool,” said many team 
members; “Waah, clowns are 
creepy,” said even more. Maybe 
it’s Halloween coming, or the craze 
for dressing up as Killer Clowns 
on the news every night, but we 
certainly felt this puppet hada 
touch of Psychoville to it. 

A fear of psychotic circus 
performers has never stopped 
us from building before, and this 
doll’s creepy clown make-up isn't 


going to stop us now. We quickly 
had ‘Mr Jelly’ out of his box and on 
the operating table. 

There’s a lot of promise in this 
build. With everything set up, you 
can make the puppet walk, wave, 
and even perform killer dance 
moves. You can get him to spot 
your wave and wave back, thanks 
to the included PIR sensor. 


Master of puppets 
The central part of the Puppet 
Kit is its four 9g servos to control 
the strings of the marionette. 
The strings are detached from 
the usual wooden cross and 
hooked up to little wooden 
arm extensions. 

A Servo Six board is wired 
directly to the GPIO pins on the 
Raspberry Pi (not included). Aside 


from the Pi and micro SD card, 
everything you need is in the box. 

Opening the kit reveals a 
plywood board, with holes 
marked for various components. 
To start the build, you screw 
in your Raspberry Pi and the 
Servo Six board to this plywood 
board. We found this first step 
the fiddliest part of the build, 
with each screw using a wooden 
washer and small nut. 

Then you move on to the 
battery box and servo motors. 
These are all attached using self- 
adhesive foam blocks, with the 
servos hanging over the edge 
of the plywood board. The idea 
is that you place the board on 
the edge of a desk or on top of 
a box, so that the puppet can 
dangle below. 
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The plywood board serves as a base for the project, 
with the Raspberry Pi and other components attached to it 


Everything is wired up using 
the ten female-to-female jumper 
cables. You connect the servos 
to the Servo Six board, and the 
latter directly to the Raspberry 
Pi. The instructions are clear and 
include a photograph for each 
step. It’s an ideal project for 
novice makers. 


GitHub. The instructions use Git 

to download (clone) the files. 
Attaching the puppet to the 

Servos requires you to cut the 

strings. But if you’re careful, 

they can be easily reconnected 

to the wooden cross to give you 

back the original puppet. Then we 

hung the puppet over the edge of 


You can make the puppet walk, 
wave, and even perform killer 


dance moves 


We only had one slight hiccup 
during the build. We didn’t have 
the micro SD card inserted into 
the Pi when we started, and 
couldn’t access the card slot when 
it was time to test the servos (the 
position of the Servo Six board 
made it impossible to get in). So 
we had to remove the Pi, slot in 
the card, and reinsert it. So make 
Sure you set up Raspbian Jessie 
with PIXEL before you get started. 


Puppet ona string 

The software side of things is easy 
thanks to Simon Monk’s Servo Six 
Python library, available from his 
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a desk and ran the test program. 
Our marionette sprang to life, just 
like Chucky from Child’s Play, and 
Started to walk. 

With the build complete, you 
can head into the two projects. 
The first is an animation 
program where you use keyboard 
commands to control the puppet 
directly. The second project 
involves using the PIR sensor to 
detect motion. As you wave to the 
puppet, he waves back. 

Spending a day with the puppet 
was highly entertaining. It’s an 
ideal way to introduce young 
students to Raspberry Pi coding. 


A great project for novices that teaches the 
basics of servo motor control in a friendly 


environment. Not for the coulrophobes, though. 


KKK 
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Maker 
says 
A handy, 
pocket-sized 
card of strong, 
meltable 


bioplastic 
FORMcard 


FORMCARD 


£004) card 


melt mould make _ mand 


FORMCARD 


An eco-friendly plastic which softens in hot water, is FORMcard the future of making: 


SUGRU 


Mouldable by 
hand, Sugru 
transforms from 
a soft putty to 
flexible rubber 
overnight — but 
you can only 
use it once. 


hen Peter Marigold’s 
FORMcard hit 
crowdfunding site 
Indiegogo, there was initial 
confusion: £5/S6 per pack for what 
appeared to be credit-card-sized 
lumps of plastic seemed a little 
over the top. Playing the video, 
though, revealed the FORMcard 
secret: it can be softened and 
worked by simply dunking it ina 
cup of hot water for a few seconds. 


Plastic fantastic 
Built from starch-based 
bioplastic, making it food- 
safe and biodegradable, each 
FORMcard represents a potential 
fix. Suggested projects range from 
building a compact screwdriver 
with a bare cross-head bit 
(FORMcard, surprisingly, having 
the strength to withstand such 
use), through to using it to encase 
electronics for waterproofing 
or repair broken casings 
on other devices. 

The standard FORMcard kit 
comes as a pack of three cards, 
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each the same size as a Standard 
credit card though significantly 
thicker; you can choose from 
black, white, grey, or a mixture 

of colours. Its use couldn’t be 
simpler: just as in Peter’s video, 
you pour a cup of hot, clean water, 
submerge the FORMcard for a 
minute or so, then fish it out witha 
spoon and it’s ready to use. 

This is where things get, quite 
literally, sticky. Unlike rival Sugru, 
which is relatively easy to work 
while soft, FORMcard is extremely 
keen on retaining your fingerprints 
for all eternity, and hardens in 
minutes rather than the average 
24-hour curing time of Sugru. 


Reusable, remouldable 
Here, though, FORMcard’s second 
trick becomes apparent: it’s almost 
infinitely reusable. Unlike Sugru, 
which hardens permanently, 
FORMcard can be softened again 
by applying more heat. Actually 
removing the softened FORMcard 
from the surface to which it was 
applied is more of a challenge, 


admittedly, but it’s still a neat 
trick and one which allows for 
temporary repairs. 

FORMcards can also be combined, 
if you need more material for 
a particular project, and their 
shape allows you to keep one in 
your wallet for those just-in-case 
moments, assuming you can find 
a source of hot water, of course! 

In testing, the FORMcards 
became soft and workable at 
around 60°C; if you’re looking to 
house or repair anything which 
gets even near this temperature, 
you’ ll need to look elsewhere for 
the solution. 


fast word 


Although not easy to work with 
and unsuitable for projects 
that get hot, FORMcard's 


strength, eco-friendly 
credentials, and reusability 
mean it should be a standard 
in every maker's toolbox. 
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MCROBOFACE 


Maker 
says 
Add 
emotion and 
fun to your 
electronic 


creation 
Atronix 


MCROBOFACE 


This bright light-up face will add character to your projects 


NEOPIXEL 
RING 


Available in 
various sizes, 
from 12 to 60 
NeoPixels, 
these chainable 
rings are an 
alternative to 
the standard 
NeoPixel strips. 
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From £6/S8 
magpi.cc/2dXaWLy 
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aunched via Kickstarter, 
McRoboFace is a PCB board 
with 17 WS2812B RGB 
LEDs, also known as NeoPixels. 
These are fully addressable and 
arranged in the shape of a face. 

At full power, they’ re blindingly 
bright and, while their intensity is 
adjustable via software, we’d advise 
purchasing the optional diffuser 
kit to soften the effect; the frosted 
acrylic diffuser is easily fitted to 
the front using three nylon screws, 
nuts, and spacers. 

Either way, you’ ll need to solder 
on the supplied four-pin right- 
angled header to connect it to your 
Raspberry Pi. It can also be driven 
by many other microcontrollers, 
including micro:bit, Arduino, 
Codebug, BeagleBone, Crumble, 
and ESP8266. When using it with 
the Pi, you have two options. The 
first method is to connect it viaa 
Picon Zero, using output 5 set to 
WS2812B. Since the Picon Zero 
also features two H-bridge motor 
drivers, it’s an easy way to create 


a wheeled robot with an expressive 
face at the front. 

Alternatively, you can hook 
the McRoboFace up directly to 
the Pi’s GPIO pins 5V and GND, 
along with GPIO 18 (the PWM 
pin) for precision control of the 
NeoPixels. While requiring a few 
extra setup steps, this method 
works perfectly well; no voltage 
level shifting is needed, as the 
pixels can be controlled using 3.3V 
quite happily. Incidentally, the 
fourth McRoboFace pin is a digital 
out for daisy-chaining with other 
NeoPixel displays. 

The Pi connection method 
will determine the Python 
programming method for 
controlling McRoboFace. Again, 
a little more setup is required 
when using the GPIO pins directly, 
including the importing of the 
neopixel (rpi-ws281x) library. It’s 
not a major hurdle, however, as 
you can just adapt the example 
code from the GitHub repo 
(magpi.cc/2dxooY3). 


Controlling the NeoPixels is easy 
enough, as they’re numbered on 
the PCB: 15 and 16 for the eyes, 

14 for the nose, and the rest for 
the mouth. Since they’re all fully 
addressable, you can adjust the 
RGB shade and brightness of each 
precisely. This makes it possible 
to create some very impressive 
fade and colour cycle effects. 
Using Python lists also enables 
you to easily change several pixels 
at once for facial expressions. 


fast word 


McRoboFace is an inexpensive 
and fun way to add a bit of 
character to your robots or 
other creations with facial 
expressions, or as a general 


NeoPixel light display. You 
could even hook it up to an 
audio input, as Robin Newman 
did (magpi.cc/2dxqZ4k), 

to ‘sing’ along to music! 
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ZERI 


Maker 
Says 
An 

easy-to-use 
8-character 
7-segment 

display add- 


on board 
Average Man 


MICRO DOT 
PHAT 


Able to display 
text and 
numbers, this 
LED matrix 
display is 

very versatile 
and renders 
characters in 
great detail. 


£22 / $27 
magpi.cc/2cfq70b 
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ZEROSE 


Build your own old-school red LED display 


hile playing around with 
some generic spare parts, 
including a standard 
seven-segment LED unit, Richard 
Saville — aka Average Man vs Pi 
(averagemanvsraspberrypi.com) 
— had the idea of creating a more 
polished, Pi Zero-sized display. 
Following a lot of reverse- 
engineering, trial and error, and 
prototyping, he came up with the 
ZeroSeg, which features two four- 
digit display units. 

The first thing to note is that it 
comes in kit form, with numerous 
components to solder onto the 
rear and front of the small board, 
including various resistors and 
capacitors. Fortunately, there’s an 
excellent online assembly guide 
to help you, as the parts need to 
be added in a specific order. Quite 
a bit of precision is required, too. 
For instance, the MAX7219CNG 
chip socket must be flush with the 
board edge to enable you to cram in 
the two LED units; when soldering 


the latter, you also need to take 
care not to touch previously added 
components on the rear. Still, 

it’s fun to put together and you 
get a sense of achievement when 
it’s completed. 

To get it working, you need to 
install the ZeroSeg Python library 
and spidev, and enable the SPI 
interface on the Raspberry Pi. In 
addition to power and ground, it 
only uses five GPIO pins: 8, 10, 11, 
17, and 26; this means there are 
still plenty to play with if you’ re 
breaking them out or stacking the 
ZeroSeg on top of another board. 

The ZeroSeg code library includes 
a few Python examples to get 
you Started, including a demo 
that shows off its capabilities, 
such as the ability to fade the 
brightness through 15 levels and 
scroll digits across the display. It’s 
fairly easy to program by adapting 
examples, although we couldn’t 
figure out a way of showing text; 
this may well have been added by 


the time you read this, although 
some letters (such as M and W) 
are impossible to reproduce on 

a seven-segment display. So it’s 
best suited to displaying digits; 
use cases include a temperature 
monitor and time/date display. 
The two programmable mini- 
buttons are a nice bonus and can 
be used to switch what’s shown. 


fast word 


While not as flexible as a 
matrix display, the ZeroSeg 

is great for value for money 
and fun to assemble. More 
suited to displaying digits than 
text, it’s fine for numerical 


data, which may be scrolled 
across the two LED units. The 
latter are bright enough at full 
power, although in daylight 
the white non-lit sectors are 
very visible. 
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ANKER 
ASTRO E1 
0Z200MAH 


You can power 
a Raspberry Pi 
using most USB 
battery packs 
designed for 
smartphones. 
These are 
bulkier and less 
integrated than 
the Zero LiPo. 


£12 / $16 
magpi.cc/2d21wiE 
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Reliable and portable power for the Raspberry Pi 


he Zero LiPo is a tiny 
add-on board for the 
Raspberry Pi that enables 
you to power it from lithium 
polymer and lithium ion batteries. 

The board itself is tiny. 
Measuring just 0.8mm thick 
and weighing 2.9g, it doesn't 
interfere with your usage of the 
Raspberry Pi. 

It attaches to the eight GPIO 
pins at the top of the pin layout 
(covering the two 5V pins, 3.3V, 
GPIO 3 and 4, and Ground). From 
here it provides power to the 
Raspberry Pi, while leaving the 
micro-USB power socket free. 

There are two ways to attach 
the Zero LiPo to the Raspberry Pi. 
You can either solder the board to 
the bottom of the standard GPIO 
header, or you can solder it toa 2x4 
female header. 

This second option enables you 
to attach, and remove, the Zero 


LiPo to/from the GPIO pins, but 
it blocks the pins. Both options 
require deft soldering skills. 

In addition to the Pi Zero, you 
can use the Zero LiPo on any 
Raspberry Pi model. 

Once attached to the Raspberry 
Pi, the board gets its power from 
a battery via a JST connector. Just 
charge up your battery, then plug it 
in to power up the Raspberry Pi. 

Pimoroni is selling a range of 
LiPo and Li-ion batteries, ranging 
from £4.50 to £18. 

We tested a1200mAh LiPo and 
a 2200mAh Li-ion battery. Both 
battery types function largely the 
same (plug and go). The board 
uses a Step-up boost converter 
(TPS61232) to convert the 3-4.2V 
from the batteries to the 5V used 
by the Raspberry Pi. 

As the battery runs out, you get 
an alert at 3.4V: ared low voltage 
warning LED comes on. The board 


ZERO LIPO 


Waker 
days 


Aims 
to give you 
the most 
compact 
Raspberry Pi 
power supply 


possible 
Pimoroni 


automatically shuts down at 3.0V. 
This protects the battery. 

The Pimoroni blog 
(magpi.cc/2d1YwCm) has detailed 
tests on how much usage you 
can expect to get in a variety of 
common tasks, across the range 
of batteries. 

In addition to the Pi Zero, you 
will need a JST charger for your 
battery, such as the Adafruit 
Micro Lipo (£7.50) or PowerBoost 
1000 (£20.50), both also available 
from Pimoroni. 


fast word 


It's a slick piece of kit, but 
make sure you factor in the 
price of the charger and 


batteries. It's a great option 
for providing safe power for 
a portable project, though. 
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RASPBERRY PI 
BESTSELLERS 


Maker Media's family-oriented series 
puts electronics and fun into learning 
and playing 


FAMILY PROJECTS FOR 
SMART OBJECTS 


Author: John Keefe 

Publisher: Maker Media 

Price: £14.50 

ISBN: 978-1680451238 
magpi.cc/2evoL2V 


Sensors, communication, and 
the whole Internet of Things 
encapsulated in simple and 
fun projects you can do with 
your children. Code is provided, 
so even beginners can try the 
projects out. 


MAKE IT GLOW: LED PROJECTS 
FOR THE WHOLE a 


Authors: Emily Coker, Kelli Townley = 
Publisher: Maker Media a 
Price: £14.50 

ISBN: 978-1680451054 
magpi.cc/2evogdC 


eote 
john K 


A lovingly presented collection 
of craft-meets-electronics 
that will enthral and enthuse 
your mini-makers. Projects 
include firefly nightlights, 
light-up tote bags, fairy wings, 
thunderclouds, a superhero 
cape, and more. 


MAKE: TECH DIY: EASY 
ELECTRONICS PROJECTS FOR 
PARENTSANDKIDS 


Authors: Ji Sun Lee, JaymesDec 


Publisher: Maker Media | 
Price: £14.50 

ISBN: 978-1680451771 
magpi.cc/2evspJS 


Felt, paper, and card meet 

LEDs, resistors, and the 

good old 555 timer chip, in | 
a collection of projects kids 

will enjoy making and using | 
- without realising they're | 
learning, too. 
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YOCTO FOR 
RASPBERRY PI 


Author: Pierre-Jean 
Texier, Petter Mabacker 
Publisher: Packt 

Price: £23.99 

ISBN: 978-1785281952 
magpi.cc/2evoD38 


The Yocto Project is 
a build system for products 
on embedded devices — popular 
boards like BeagleBoard and the 
Raspberry Pi — and the Pi’s extra 
erunt makes it an ideal platform 
for developing and trialling Yocto 
builds of embedded apps, ina 
more realistic environment than 
running inside QEMU on your PC. 
A complex collection of 
tools, processes, templates, 
and methods, getting started 
with Yocto is greatly aided bya 
well-ordered guide. Texier and 
Mabacker provide a step-through 
guide to working with BitBake, 


BUILDING A VIRTUAL 
ASSISTANT FOR 


RASPBERRY PI 


Author: Tany Pant 
Publisher: Apress 
Price: £14.99 

ISBN: 978-1484221662 
magpi.cc/2evszRu 


From Siri to Tony 
Stark’s Jarvis, 
everyone is speaking 
to virtual assistants, but how about 
creating your own? Tanay Pant’s 
concise guide does just that and, 
despite the slightly grating (but 
presumably postmodern ironic) 
aspect of the female-voiced 
assistant greeting those who 
follow the project with a 1960s 
assistant-style “Hi, handsome”, 
bear with it as the project is 
well put together and actually 
quite useful. 

A virtual assistant is made up 
of speech-to-text (STT), logic, 
and text-to-speech (TTS). STT is 


Yocto for Raspberry Pi 


OpenEmbedded-Core, Poky, BSP 
(the meta-raspberrypi layer), 
introducing Yocto workflow, 
building your first system 
with Poky, and the BSP layer 
for Raspberry Pi. These layers 
are assembled as recipes, then 
put through BitBake to build 
the image for the Pi’s SD card. 
After working through 
BitBake’s powerful features, 
the authors look at Raspberry 
Pi-specific aspects of 
developing with Yocto, and 
introduce a project to work with 
the Pi’s GPIO pins. The provided 
code is in C, but shouldn’t be too 
much of a stretch for anyone with 
programming basics. Further 
Yocto layers follow, built of 
collections of recipes, for better 
organisation of larger projects. A 
home automation project brings 
together everything learned. 


Score 


farmed out to Google’s powerful 
service, but other options are 
considered, and you can substitute 
in one of them. TTS is provided 
by the eSpeak package, and some 
basic code soon gets the reader 
in ‘conversation’ with the Pi 
(once you’ve acquired a USB 
microphone for it!). The rest 
of the book builds the logic 
layer to add to the assistant’s 
accomplishments. 
All code is in Python, anda 
lot of conversation depends 
on if-elif-else statements. Siri- 
style look-ups of definitions 
from Wikipedia, or the day’s 
weather or business news, form 
the basics, but adding Selenium 
testing of your website(s) opens 
the reader’s eyes to other 
possibilities. A music player, 
note taker, and Twitter interface 
are followed by suggestions for 
further development. 


Score 
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MACHINE LEARNING 
FOR DUMMIE 


Author: John Paul Mueller, a 
Luca Massaron 
Publisher: Wiley 
Price: £21.99 

ISBN: 978-1119245513 
magpi.cc/2evs364 


A brave move ina 
beginner’s book 
is to make the reader learn two 
languages — Rand Python — but 
R has great strengths in dealing 
with statistics, and Python is the 
best general-purpose language for 
machine learning. It’s all about the 
data, and the language intros get 
Straight to work on manipulating 
mathematical matrices, lists, and 
multiple-dimensional arrays. 
Unlike many ‘... for Dummies’ 
series books, this one seems aimed 
more at traditional learners, with 
fewer space-filling diagrams, and 
far more instructive text. To give 
a rounded picture of machine 


THE NEO- 
GENERALIST 


Author: Kenneth Mikkelsen, 


Richard Martin 
Publisher: LID es | 
Price: £12.99 ©-GENERALIST 


ISBN: 978-1910649558 
magpi.cc/2evq7KV 


While the US 
Department of Labor 
States that two-thirds 
of children in primary schools 
today will work in jobs that have 
not yet been invented, many of us 
have been making up careers as 
we go along for a long time. The 
rhyme ‘Jack of all trades / Master 
of none’ was completed in the 
original Elizabethan form with 
‘Oft’ times better / than a master 
of one.’ 

The Neo-Generalist takes in 
all who switch from generalist 
to hyper-specialist: the multi- 
hyphenate, portfolio or slash 
career; full stack engineers; 
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Machine Learning 


learning — avast topic — the 
book jumps between practical 
and informational sections, and 
some readers may find 
themselves skipping back 
and forth among sections 
to get the most out of it. 
And what a lot there is 
to get out of this one: the 
future of machine learning; 
language intros; maths 
and statistics (all of that 
high school learning you’ve 
forgotten); a great introduction 
to many of the algorithms you 
need to know; working examples 
in R and Python to illustrate 
what you’ve learned; and a great 
selection of machine learning 
problems tackled using the skills 
you've been learning, followed by 
a look at where to explore next. 
Comprehensive, and not just 
for dummies. 


Score 


tinkerers; inventive dilettantes 
who are a familiar feature at 
makerspaces and at Python 
conferences where, for example, 
a Surprising percentage of 
coders have a background 
as professional musicians; 
and those who follow a 


i ‘continuum of options’. 


The authors’ sweeping 
style - reminiscent of 
Leslie Kenton — won’t be 
to all tastes, but they’ve 

done a magnificent job of 
showing multiple possibilities 
that exist for creative people in 
our changing times, illustrated 
with dozens of interviewees from 
many walks of life, and frequent 
crossings between disruptive 
technology, the arts, and social 
enterprise. If you find yourself 
‘living in more than one world’, 
take heart: you’re certainly 

not alone. 


Score 


ESSENTIAL READING: 


GNU EMACS 


Get to grips with the programmer's editor that 
thinks it’s an operating system 


Harley Hahn’s Emacs Field Guide 


Author: Harley Hahn 
Publisher: Apress 
Price: £19.99 

ISBN: 978-1484217023 
magpi.cc/2evrRUz 


The veteran tech author brings his 
beginner-friendly style to introducing 
Emacs. Abounds with history, geekiness, 
and clear explanations. 


Emacs 


Author: N/A 
Publisher: GNU 
Price: N/A 

ISBN: N/A 
magpi.cc/2evq6qd 


Emacs is a self-documenting editor with 
built-in tutorial. So, Ctrl-h a searches for 
the appropriate Emacs info page. 


Mastering Emacs: 2nd Edition 


Author: Mickey Petersen 


- MASTERING - 


Publisher: ebook - masteringemacs.org 
Price: $39.99 , 
ISBN: N/A EMACS | 


magpi.cc/2evrhGi 


Rw, 


7 
=a MICKEY PETERSEN 
aN 


Philosophical and practical guide to Yass 
the ultimate ‘tinkerer's editor, updated i 
for Emacs 25. Thoughtful, immersive, eee 


and full of useful workflow tips. 


— Abas Oe 


Sacha Chua’s Emacs blog 


Author: Sacha Chua 

Jim Mlodgenski & Kirk Roybal 
Publisher: N/A — blog _—an 
Price: N/A 

ISBN: N/A 

magpi.cc/2evsOvW soubuneia 


Rivalling (or surpassing!) the EmacsWiki, 
from an A3 poster introducing Emacs to 
beginners, to detailed modifications of 
numerous modes. 


The Org Mode 8 Reference Manual 


Author: Carsten Dominik 1 fe) MINEAL 
Publisher: Samurai Media r rh art . 
Price: £16.03 cope yn tn wh GRAS EE 
ISBN: 978-9881327703 
orgmode.org 


Written by Org Mode's original author. 
Organise your projects, your business, 
and your life, with Emacs’ secret weapon. 
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THE MONTH IN 
RASPBERRY PI 


Everything else that happened this month in the world of Raspberry Pi 


B4 


ne of the biggest events on the maker calendar 
is the World Maker Faire in New York, and it’s 
a bit of a tradition with the Raspberry Pi team; 
before the computer came out in 2012, the Raspberry Pi 
was being demonstrated by (the very small) team Pi. 

Things have changed a lot since then and Raspberry 
Pi was a prominent presence at this year’s event, with 
members from the Foundation and Trading company 
attending to help out. This included The MagPi’s Lorna 
Lynch, who has blogged about the experience in detail 
on the Raspberry Pi blog (magpi.cc/2emXdBxX). 


RASPBERRY PI LIVE! 


Feel like you missed out by not going 
to see Raspberry Pi in New York? The 
team recorded a live video tour of 
the Pi booth and surrounding areas at 


the Maker Faire, which you can watch 
on the Raspberry Pi Facebook page 

by following the shortlink. It might 

be a good idea to get the page liked 

if you want to be ready for the next 
livestream: facebook.com/raspberrypi 
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magpi.cc /2ejpaoK 


A handy sign 
pointing you in the 
right directions at 
Maker Faire 


“AS in previous years, there were many excellent 
Raspberry Pi-based projects, as well as familiar faces 
from the Pi community. There was an excellent display 
of Pi-controlled Lego Mindstorms robots. We also 
met the guys from Pi Supply showcasing their new 
JustBoom equipment, bringing affordable high-quality 
audio to Raspberry Pi users. Eager experimenters of all 
ages came to try out our Sense HAT activities, and to 
tell us about the Pi projects they had made at home. 
One man was even wearing a Pi Zero as a necklace!” 

It looks like it was a lot of fun; we hope to see you 
there next year, or maybe even at the Bay Area Maker 
Faire in May! 


It tipped down with rain during 
setup the day before, but that 
didn't stop our brave volunteers 
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THIS MONTH IN PI 


CROWDFUND THIS! 


The best crowdfunding hits this month for you to check out... 


SPY V. SPI 
=z # #$:;+j 


A lot of Raspberry Pi robot kits you can buy have an 
educational slant, teaching you code and/or robotics 
as you create and program your robot. Spy v. sPi 
takes this educational angle in a different direction, 
with the robots being built and programmed to fulfil 
missions in what Dexter Industries are calling a 
‘capture-the-flag adventure’. This is done by using 
sensors to protect or capture an electronic treasure 
the teams are vying for. It sounds like a lot of fun, 
and with your help they can get it out. 


SPIRIT ROVER 


This campaign will have finished by the time this goes 
to press. However, it’s hit the goal so expect to see 
more of it soon: it’s another learning robot, but this 
one is based on Mars rovers! It combines Raspberry Pi 
and Arduino for the usual robo-education of building 
and coding. This one is fairly unique, as it has a row of 
awesome NeoPixels on its chassis and just under the 
ultrasonic sensors to make it look like it has a face. 
It’s got a lot of amazing functions, so it’s definitely 
one to keep an eye on. 
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PISHIELD 


kck.st/2dCw8c1 


Here’s something that’s a bit more 
of a utility. The PiShield is a shield 
for the Pi Zero that adds eight 
5V analogue sensor ports and 
four I?C device ports to the 

Pi. As its form factor is 
designed for the Pi Zero, 
that means it also fits Ps 
on other Raspberry o*,, 
Pis, as long as they have 

the 40-pin GIO) linismmalkes 

it pretty useful for many robot or 
home automation projects, and it’s 

actually already been funded. Just a $20 
(Canadian) pledge guarantees one for yourself. 


BEST OF THE REST 


magpi.cc/ 2ejoyiX 


yarrTw DRONE WITH 


PI CART 
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Matt hosts the 
redpepper ‘Touch of Tech’ 
online series, highlighting 

the latest in interesting and 
unusual tech releases 


Matt spends his days creating awesome 
builds for integrated marketing agency 
redpepper in Nashville, Tennessee 


att’s background is in 

web design/development, 

extending to graphic design 
in which he acquired his BFA at the 
University of Tennessee-Knoxville. 
In his youth, his passion focused 
on car stereo systems, designing 
elaborate builds that his wallet 
couldn’t afford. However, this 
enriched his maker skill set by 
introducing woodwork, electronics, 
and fabrication exploration into 
his creations. 

Having joined the integrated 

marketing agency redpepper eight 


years ago, Matt originally worked 
in the design and production 

of microsites. However, as his 
interests continued to grow, 
demand began to evolve, and 
products such as the Arduino 
and Raspberry Pi came into mix. 
Matt soon found himself moving 
away from the screen toward 
physical builds. 

“T’m interested in anything that 
uses tech in a clever way. Whether 
it be AR, VR, front-end, back-end, 
app dev, servers, hardware, UI, 
UX, motion graphics, art, science, 


- 


\ 
rn Ws 


raspberrypi.org/magpi 


Sniffur allows Matt to keep tabs on his roaming greyhound, 
Bean, using a collar-mounted beacon and three Raspberry Pis 


or human behaviour. I really enjoy 
coming up with ideas people can 
relate to.” 

Matt’s passion is to make tech 
seem cool, creative, empowering, 
and approachable, and his projects 
reflect this. Away from the 
Raspberry Pi, Matt has built some 
amazing creations such as the Home 


Matt continues to bridge the gap 
between the company’s day-to- 
day business and the fun, intuitive 
uses of tech. Not only do they offer 
technological marketing solutions 
via their rpLAB, they have 
continued to grow, incorporating 
Google’s Sprint methodology into 
idea building and brainstorming 


Im interested 1n anything that 
uses tech 1n a clever way 


Alone Holidaython, an app that lets 
you recreate the famous curtain 
shadow party in Kevin McCallister’s 
living room. Pick the shadow you 
want to appear, and projectors 
illuminate the design against a 
sheet across the redpepper office 
window. Christmas on Tweet Street 
LIVE! captures hilariously negative 
Christmas-themed tweets from 
Twitter, displaying them across a 
traditional festive painting, while 
DOORS8ELL allows office visitors 
the opportunity to Slack-message 
their required staff member via an 
arcade interface, complete with 
8-bit graphics. There’s also been 
a Capacitive piano built with jelly 
keys, a phone app to simulate the 
destruction of cars as you sit within 
traffic, and a working QR code made 
entirely from Oreos. 

Playing the ‘technology 
advocate’ role at redpepper, 
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within days of receiving a request, 

“so having tools that are powerful, 
flexible, and cost-effective like the 
Pi is invaluable.” 

“| just love the intersection of 
art and science,” Matt explains 
when discussing his passion for 
tech. “Having worked with Linux 
Servers for MOSt Of my Career, the 
Pi was the natural extension for 
my interest in hardware. Running 
Node.js on the Pi has become my 
go-to toolset.” 

We’ve seen Matt’s Raspberry Pi- 
based portfolio grow over the last 
couple of years. A few of his builds 
have been featured in The MagPi, 
and his Raspberry Preserve was 
placed 13th in the Top 50 Raspberry 
Pi Builds in issue 50. 

There’s no denying that Matt 
will continue to be ‘one to watch’ 
in the world of quirky, original 
tech builds. 
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EVENTS 


Community 


EVENT CALENDAR 


Find out what community-organised, Raspberry Pi- 
themed events are happening near you... 


Want to add your get-together? 
List it here: 


raspberrypi.org/jam/add 


Want a Raspberry Jam in your 
area? Want to start one? 
Email Ben Nuttall about it: = 


ben@raspberrypi.org 


GRC) MN aDE NERS 


3, 


BALTIMORE 
RASPBERRY JAM 


RASPBERRY JAM 
BOGOTA 


TOKYO RASPBERRY JAM 

#007 

When: Sunday 6 November 

Where: Hodokubo 2-1-1, Hino, 
Tokyo, Japan 

magpi.cc/2dNUfT6 

The Japanese Raspberry Pi Users 

Group is putting on a Jam for 


Tokyo locals to learn about the Pi. 


2ND WIMBLEDON 

RASPBERRY JAM 

When: Sunday 13 November 

Where: Wimbledon Library, 
Wimbledon, UK 

magpi.cc/2dNW4zu 

Projects and talks from teachers 


and children to help inspire people 


in computing and using the Pi. 
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RASPBERRY JAM BOGOTA 
When: Saturday 19 November 
Where: Avenida El Dorado Carrera 

45 # 26 - 33, Bogota, DC, 

Colombia 
miraspberrypi.com 
Presentations and workshops at 
the first and longest-running 
Latin Raspberry Jam. 


BALTIMORE 

RASPBERRY JAM 

When: Saturday 3 December 
Where: Digital Harbor Foundation 
Tech Center, Baltimore, MD, USA 
magpi.cc/2dNYFsU 

Dedicate some time to exploring 
the Raspberry Pi or working on 
your own Pi projects. 


#007 


REGULAR EVENTS 


RASPBERRY JAM LEEDS 
When: Wednesday 2 November 
Where: Swallow Hill Community 
College ecds, Wik 
magpi.cc/2dNPDfP 
Everyone is invited for a couple 
of hours of computing fun, 
talks, demonstrations, and 
hands-on workshops. 


RASPBERRY JAM 

PRESTON 

When: Monday 7 November 

Where: Media Innovation Studio, 
Preston, Wik 

magpi.cc/2dNRpok 

Learn, create, and share the 

potential of the Raspberry Pi 

at a family-friendly event. 
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TOKYO RASPBERRY JAM 


Community 


JAMS 
EVERYWHERE! 
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fh TORBAY 
TECH JAM 


TORBAY TECH JAM 
When: Saturday 12 November 
Where: Paignton Library and 
Information Centre, 
Paignton, UK 
torbaytechjam.org.uk 
A fun, informal, and family-friendly 
event that aims to inspire people to get 
into code and take up STEM subjects. 


HULL 
RASPBERRY JAM 
When: Saturday 12 November 
Where: Malet Lambert School, 
Hull, UK 
magpi.cc/2dNRAJ6 
Bringing people together from across 
a wide area to discover the exciting 
potential of the Raspberry Pi. 
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FILL IN THE GAPS! 


SCOTLAND NEEDS RASPBERRY JAMS 


The Glasgow Raspberry Pi Day was great: 


Raspberry Jam community 
manager Ben Nuttall would 
like you to help Raspberry 

Pi spread Raspberry Jams 
ground the country, and one 
area that could do with more 
is Scotland. If you're handy 
with a Raspberry Pi and know 
others who are, see over the 
page to find to some top tips 
on setting up and getting 
people interest in attending 
a Raspberry Jam near you. 


let's get more Jams in Scotland! 
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CTT INTERVIEW 


BLACKPOOL 
RASPBERRY JAM 


AN INTERVIEW WITH LES POUNDER 


Practical tips for running a Jam for your local community from the chief, Les Pounder 


ontributor to the magazine 
and Raspberry Jam runner 
Les Pounder talks to us 
about his experiences. 


How did you find out about 
Raspberry Pi? 

“Having used Linux since the late 
1990s, I was always on the lookout 
for new Linux devices. Whilst 
reading the BBC’s technology 
page, I stumbled upon Rory 
Cellan-Jones’s piece introducing a 
new small computer, which at the 
time resembled a USB flash drive. 
I was intrigued and so, along with 
many others, I was online at 6am, 
29 February 2012 and managed to 
secure my first Raspberry Pi.” 


LES POUNDER 


Les Pounder is a maker, author, and hacker 

who lives in the UK. He regularly works with the 
Raspberry Pi Foundation to deliver Picademy 
training to teachers. He also writes a blog at bigles 
for some of his crazy ideas. 
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How did you get involved in the 
Raspberry Pi community? 
“Since day one I have been a 


staunch supporter of the Raspberry 


Pi as a platform for social change 
and invention. When I first 
started in the community, I knew 
nothing about programming and 
electronics, but with the help of 
the community and quite a lot of 
rather basic questions, I quickly 
understood what could be done 
with the Raspberry Pi. The main 
service that the community 
provides is support. Without it, 
the Raspberry Pi would just be 
another single-board computer 
vying for the attention of the 
masses. The community embraced 
the Raspberry Pi and created many 
wonderful projects that benefit 
everyone in many different ways. 
Children learn to code, become 
inspired through science and 
engineering thanks to Astro Pi, 
and learn how data can be used to 
shape our lives. The community 
are the backbone that support the 
project, and I would like to say 
thanks to every member of the 
Raspberry Pi community.” 


What was the first Raspberry Jam 
you attended: 

“My first Jam was in Manchester, 
hosted by a fresh-faced Ben 
Nuttall. At this Jam I met many 
like-minded individuals, including 
a rather young Amy Mather who 
has now gone on to great things. 


This Jam was one of the very first 
to exist and, at the time, it was 
testing the water as to howa Jam 
should be organised. There were 
lots of tables full of Raspberry Pis 
being used to play videos using 
XBMC, and children learning to 
make games with Scratch and 
doing basic Python programming.” 


Why did you decide to start the 
Blackpool Raspberry Jam? 
“Blackpool isn’t exactly a tech 
hub. Our transient population 
relies on seasonal work and, as 
such, Blackpool suffers from many 
social issues, of which poverty is 
one. I started Blackpool Raspberry 
Jam as a way to introduce 
computing and creating inventions 
to the children of the area. We 
take the Jam on the road to the 
many libraries of Blackpool and its 
surrounding boroughs. Blackpool 
Libraries have supported our 

Jam since day one and provide a 
free venue inside a local library, 
which means that we don’t have 
to charge our attendees, and this 
enables us to provide free access 
to the Raspberry Pi.” 


How did you go about organising 
the first Blackpool Jam? 

“Once I organised a venue with 
Blackpool Libraries, the rest 

just fell into place. I already had 
plenty of Raspberry Pi computers, 
power supplies, and cables. All I 
needed were keyboards, mice, and 
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screens, which the local library 
was able to make available to us. 
But really, for a Jam all you need 
iS a Space, some tables, and access 
to power and WiFi. Then invite 
people from your local community 
via posters in community spaces. 
We approached Blackpool Council 
to provide advertising across 
Blackpool at all public libraries 
and museums. Once we had 

the advertisements and venue 
sorted, everything else was easily 
manageable thanks to the great 
team of STEM Ambassadors 

that work with me at Blackpool 
Raspberry Jam.” 


What activities did you put on at 
the Jam? 

“| offered lessons for those new to 
the Raspberry Pi to enjoy. Nothing 
formal, just fun bite-size projects 
that can be completed with very 
Mine Coa ainal Niveiny Meche: cine: 
ideal for children with a short 
attention span. Seriously, you can 


Me 


* 


have so much fun using a jelly baby 
as a push-button burp trigger! 

For more advanced attendees, 

we provided space and facilities 

for them to show their projects 

to the group. We’ve seen robots, 
scary spooks that react to sound, 
and many LED projects created by 
children in the local area.” 


How did the Jam go? How many 
people attended: 

“For our first Jam we had around 
20 people turn up, including 
Raspbetry Pi co-founder Pete 
Lomas who gave a great talk on 
how the Picame to life. Each 
month at the Jam we now see 
around 12 people attend, which is 
perfect for the small space that we 
have. What I like about just having 
12 people is that we have parents 
learning with their children, and 


my team and I have the time to talk 


to them and offer advice, ideas, 
and suggestions on all manner of 
Raspberry Pi queries.” 
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* LAUNCH 


LIKE A PRO * . 
For Resale 


Featuring an SD card preloaded with a custom version of 


01. EXPERIENCE 


Attend a few different Jams in your area and geta 
feel for how each of them is run. Take the best bits 
and use them for your Jam. 


03. PERSEVERANCE 

Don't worry if you don't attract many people - 
quality of interaction with your attendees will 
create a better Jam than having hundreds of 
people that you never speak to. 


Not 


, 


walt 
WoL» 


NOOBS along with Raspbian PIXEL and Raspbian Lite operating 
systems, the WD PiDrive Foundation Edition is ready to help 
you explore new worlds in a matter of moments. 


© wDLABS 


wdlabs.wd.com 


LETTERS 


There's a lot that International keys 
comes with the Yuen s ° ° ° ° 
pe eae I’ve just PCeWves issue 50, along with an email from 
the keyboard my wife asking if I wanted to renew the subscription. 


I actually told a client I had to call them back so I 
, could phone my wife and tell her not to cancel it 
Se under any circumstances! 
( It was great to learn that the Raspberry Pi 

| Foundation are offering an official starter kit as, 
having bought Pis from the start (actually being 
one of the first people to email them about it before 

[ the website was even set up), there has often been 
. i difficulty getting peripherals that work first time. 
ee a 7 It’s not the case any more, but it was when they first 
came out. 

‘ a What disappoints me is the keyboard seems to 
be the standard US layout, and not the UK layout 
we know and love. I know there are only two 

silat differences between the two: the placement of the 
“ and @ symbols. For a developer like me, though, 
ee that’s a massive difference between code working 


3 
oa 
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Make it happen 

Dear MagPi, 

Congratulations on 50 issues and 10 million 
Pis. I’m happy to see that in your list of the 

50 greatest Raspberry Pi projects of all time, 

no fewer than two were made at Makespace, a 
maker community and space in Cambridge. Both 
Tom Oinn’s mind-bending robot Triangula and 
Brian Corteil’s Digital Zoetrope might never 
have been made without Makespace’s laser 
cutters, electronics equipment, and assorted 
other kit, and above all, its supportive and 
enthusiastic community. 

Around the world, makerspaces are springing 
up and helping to equip and train a whole 
generation of makers, from beginner to expert 
and from children to pensioners. If they are 
anything like Makespace, I expect they’re all 
hotbeds of Raspberry Pi projects, too. Perhaps we 
might see a feature on them in a future issue? 


Mark Wainwright 


Hi Mark; we’ve heard many wonderful things 
about the Makespace in Cambridge, especially as 
its in the Pi’s home town. We don’t have anything 
to announce just yet, but we definitely have been 
talking about doing some stuff on makerspaces: 
watch this space! 


and having to spend hours going through it to find 
your mistake. 

Can you let us know via the next issue if that’s 
the actual keyboard we will receive, or if UK buyers 
will get the UK version? I buy these for people all 
the time as they’re so inexpensive, so knowing 
I can get a starter kit in a UK layout will tell me 
whether to purchase one for those people or not. 
lan Williams 


Hi Ian; we hope you didn’t get in any trouble with 
your client for having to hang up! As for the layout of 
the official keyboard, it’s the American layout even 
on those bought in the UK for the moment. It’s still 

a lovely little keyboard, and well worth having to 
change your thinking around a bit just to make sure 
you’re using the right keys. You could also probably 
pick up another keyboard that will work for very little 
money if you absolutely need it! 
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FROM THE FORUM: 


ARTICLE 
DATABASE 


The Raspberry Pi Forum is a hotbed of 
conversations and problem-solving for the 
community - join in via raspberrypi.org/forums 


ello, 

It would be very useful to have a table of contents for all 

issues (regular issues and all special topic issues) of The 
MagPi which could be searched. 

For example, it would be useful when I would like to find all issues 
of The MagPi which are part of a guide to learn C (which would be 
issues 47, 48, and 49). 

Is something like this already available? If not, would it be 
possible to produce something like this? 

Best regards, 
Supermerlin 


There’s a database available for the first 30 issues of The MagPi 
(magpi.cc/2ds5RbZ) and we have heard of a few people that keep 
their own database of all the articles in each issue. It’s absolutely 
feasible, though, and we’d certainly welcome someone creating 
and maintaining a database for us online, as it would help out the 
editorial team at times. 

If you have a public database of all The MagPi articles, please get 
in touch; we can try to do something to help and make sure it’s got 
a bit more notoriety! 


WRITE TO US 


Have you got something you'd like to say? 


Get in touch via magpi@raspberrypi.org or on The MagPi 
section of the forum at: raspberrypi.org/forums 
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In association with 


pi-top 


Www.pl-top.com 


Y 
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ONE OF TWO 
PI-TOPCEEDS 
OR A PI-TOP! 


PI-TOP IS A DIY LAPTOP AND PI-TOPCEED IS THE ALL-IN-ONE 
DESKTOP, BOTH POWERED BY THE RASPBERRY Pl 


The ideal maker devices and learning tools for STEAM education. Both come 


with pi-topOS to easily start coding, building circuits, and making hardware. 


WHICH 
CROWDFUNDING 
SITE DID THE 
ORIGINAL PI-TOP 
LAUNCH ON? 


Tell us by 21 November Simply email competition @raspberrypi.org 
for your chance to win! with your name, address, and answer! 


Terms & Conditions 

Competition closes 21 November 2016. Prize is offered worldwide to participants aged 18 or over, except employees of the Raspberry Pi Foundation, the prize supplier, 
their families or friends. Winners will be notified by email after the draw date. By entering the competition, the winner consents to any publicity generated from the 
competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine (unless otherwise stated upon entry). We don't like 


spam. Participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. 
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Love your Pi? Love Music? 


Designed by audio experts, enjoyed by everyone 


Jaw dropping audio quality for your Raspberry Pi 
It))) Connect Headphones, Speakers, RCA, Toslink, S/PDIF or XLR 
Sonic P We work with all the major music solutions to ensure compatibility 
ONIC FI 


E=eeeed YOLUMIO (OOP) @Archphite JU Kopi Fiagetae 


PiMusicBox 


Twitter: @IlQ_audio 


lQaudio Limited, 
Email: info@iqaudio.com a U e C) Cricklade Wiltshire. 
Web: www.igaudio.com 


Company No.: 9461908 
MORE ADVANCED 
Semel ee 


Get started today for MOST POPULAR LANGUAGE 


just £2.99 / $3.99 von Raspberry Pi 


4 Available on the 
€ App Store 
GET IT ON 
~ Google Play 


magpi.cc/learn-c-book 


® From the makers of the 
official # © official Raspberry Pi magazine P1 magazine 
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Column | THE FINAL WORD 


aking things can change your life. It did 
for me, and I hear the same from others 
all the time. 

After I graduated from university in 2003, I jumped 
immediately into the workforce. I landed in New York 
City’s entertainment industry, which is where I’d 
dreamed of working since I was young. I was excited 
to be a staffer on a major television show, where | 
learned what it takes to produce a weekly television 
drama. I slowly worked my way up the ladder in the 
television industry over a few years. 

There’s a lot to admire about how film and 
television content is produced. A crew of over one 
hundred people with creative and technical talents 
come together to create a piece of entertainment, 
under the watchful eye of the director. It’s an 
enormous piece of creative collaboration, but 
it’s also a business. Everyone does their part to 
make it happen. It’s incredible to see a television 
show get made. 

I had found a niche in the television industry that 
I did well in, but eventually I hit a rut. 1 had a small 
role in a big piece of work. I wanted to be more 
creative, and have more autonomy and influence over 
what I was helping to create. It was at that time that | 
started closely following what makers were doing. 

Feeling inspired by the work of others, I started to 
make things with microcontrollers and electronics. 
I'd then share how to do these projects online. 
Eventually, I was contributing projects to Make: 
magazine and I was soon able to make side money 
from making things for companies, writing about 
how to make, and writing about what others were 
making. Soon enough, I was finding enough jobs 
to leave the television industry and work asa 
maker full-time. 
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MATT RICHARDSON 


Matt is Raspberry Pi's US-based product evangelist. Before 
that, he was co-author of Getting Started with Raspberry Pi 
and a contributing editor at Make: magazine. 


. Matt Richardson tells his story of going from hobbyist to career maker 


That eventually led to my current job, doing 
outreach for Raspberry Pi in the United States. It’s 
incredibly gratifying work and despite the long road 
to get there, I couldn’t be happier with what I’m 
doing. The spare time I| invested in making things as 
a hobby has paid off greatly in a new career that gives 
me creative freedom and a much more interesting 
work day. 


Make it happen 

I meet people all the time who have stories about 
how making has had an impact on their lives. At 
World Maker Faire New York recently, I met student 
Gerald Burkett; he told me his story of becoming 

a maker. He said, “I’m doing things I wouldn’t 

have ever dreamed of just four years ago, and it’s 
changed my life for the better.” And Gerald is 
having an impact on others as well. Even though 
he’s soon graduating, he’s encouraging the school’s 
administration to foster makers among students. 
He says that they “deserve an inviting environment 
where creativity is encouraged, and access to tools 
and supplies they couldn’t obtain otherwise in order 
to prototype and invent.” 

Because of more accessible technology like 
Raspberry Pi and freely available online resources, 
it’s easier than ever to make the things that you want 
to see in the world. Whether you’re a student or are 
far down a particular career path, it’s also easier than 
ever to explore making as a passion and potentially 
also a livelihood. 

If you’re reading this and you feel like you’re stuck 
in a rut with your job, I understand that feeling and 
encourage you to pursue making with vigour. There’s 
a good chance that what you make can change your 
life. It worked for me. 
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on” mindsensors.com 


Think @ Create @ Learn e Educate 


PiSTORMS-V2 


Make Stunning Robots with 
LEGOs and Raspberry Pi | 


B COMPONENTS |. A.V GE 


The perfect 
companion for 
the SB Components’ 
Motor-Shield 


l 


LEARN | CODE | MAKE 


ONLY £4/$6 
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serial Pi Plus 


RS232 serial communication board. 
Control your Raspberry Pi over RS232 
or connect to external serial 
accessories. 


Breakout PF! Plus 


The Breakout Pi Plus is a useful 
and versatile prototyping expansion 
board for the Raspberry Pi 


ADC Ditferential P 


8 channel 18 bit analogue to digital 
converter. I*C address selection 
allows you to add up to 32 analogue 
inputs to your Raspberry Pi. 


IO Pi Plus 


32 digital 5V inputs or outputs. I?C 
address selection allows you to stack 
up to 4 1O Pi Plus boards on your 
Raspberry Pi giving you 128 digital 
inputs or outputs. 


RIC Pi Plus 


Real-time clock with battery backup 
and 5V I°C level converter for adding 
external 5V I?C devices to your 
Raspberry Pi. 


| Wire Pi Plus 


1-Wire® to I?C host interface with ESD 
protection diode and I*C address 
selection. 


electronics 


AISO 
available 
for the 
Pi Zero 


_ 
“4h 


SPY vs. SP! 


CODE. CAPTURE. DEFEND. 


ra 


Spy vs. sPi is a capture-the-flag style engineering 
adventure that puts real purpose to basic design and 
programming skills. It can be played individually or in 
teams and is based on the GrovePi. 


Each “spy” is assigned a series of missions, requiring by 
them to write code to control an assortment of rs = 
sensors that will allow them to protect their “jewel” i = D> 
in different ways, or capture the “jewel” of a mn S- 
competing spy. 


Back us on Kickstarter Sept. 20-Oct 31, 2016! G if O V eC 
www.dexterindustries.com/spy 
Build your own spy device, alll 
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BrickPI 


\ Raspberry Pi + LEGO MINDSTORMS 
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